Share via

GPE::Line

  • Article

This method executes before and after a sequence of line segments, which are drawn as a path.

SCODE GPE::Line( 
  GPELineParms* pLineParms, 
  EGPEPhase phase 
);

Parameters

  • pLineParms
    [in] Pointer to a GPELineParms structure containing parameters for the line.
  • phase
    [in] Set to one of the values in the following table.
    Value Description
    gpeSingle For single lines.
    gpePrepare For initializing the display hardware to draw several lines with similar parameters.
    gpeContinue For lines that are part of a sequence of line drawing operations.
    gpeComplete Signals the end of a sequence of line drawing operations.

Return Values

None.

Remarks

This is the only pure virtual line drawing method that you must overload in a GPE-based driver.

When called before a line sequence, the phase parameter has the value gpePrepare. Once the sequence is complete, the graphics device interface (GDI) calls this method with the value gpeComplete in the phase parameter.

The GPE::Line method examines the line parameters to determine whether the operation can be accelerated. It also places a pointer to a function to execute once per line segment into the pLine member of the GPELineParms structure. To use the emulated line drawing code supplied as part of the GPE, execute the following code.

pLineParms->pLine = EmulatedLine;
return S_OK;

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Gpe.h.
Link Library: Gpe_lib.lib.

See Also

Display Drivers | GPELineParms

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.