 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This method is called 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 GPELineParmsstructure containing parameters for the line.
- phase
- Phase of drawing for this call, either
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, or
gpeComplete, which signals the end of a sequence of line
drawing operations.
Remarks
When called before a line sequence, the phaseparameter has the value gpePrepare. Once the sequence is complete, the GDI calls this method with the value gpeCompletein the phaseparameter.
The GPE::Linemethod examines the line parameters to determine whether the operation can be accelerated. It also places a pointer to a function to be called once per line segment into the pLinemember of the GPELineParmsstructure. To use the emulated line drawing code supplied as part of the GPE, the following code should be executed.
pLineParms->pLine = EmulatedLine; return S_OK;
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004