GPE::Line (Windows CE 5.0)
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
Send Feedback on this topic to the authors