ExtractPenDataPoints
2.0
Extracts
points from a specified stroke in an HPENDATA object.
int ExtractPenDataPoints( HPENDATA hpndt,
UINT iStrk, UINT iPnt, UINT cPnts,
LPPOINT lppt, LPVOID lpvOem, UINT fuOption
)
Parameters
hpndt
Handle to an HPENDATA
object.
iStrk
Zero-based
index of the stroke to remove points from.
iPnt
Zero-based
index to the first point to remove.
cPnts
Count of
points to remove. If this value is greater than the number of points after iPnt,
all the points from iPnt to the last point of the stroke are removed. ExtractPenDataPoints
fails if iPnt is greater then the number of points in the stroke.
lppt
Array of POINT structures that receives
the extracted points. This must be large enough to hold cPnts points.
lpvOem
Buffer to put
extracted OEM data if it exists, or NULL. This must be large enough to hold cPnts
OEM packets.
fuOption
Flags. This
value can be EPDP_REMOVE to remove the points from the stroke in the pen data
object.
Return Value
Returns
PDR_OK if successful; otherwise, the return value can be one of the following
negative values:
|
Constant |
Description |
|
PDR_COMPRESSED |
Pen data is
compressed. |
|
PDR_ERROR |
Parameter
or other unspecified error. |
|
PDR_MEMERR |
Out of
memory. |
|
PDR_STRKINDEXERR |
Invalid
stroke index. |
|
PDR_PNTINDEXERR |
Invalid
point index. |
|
PDR_VERSIONERR |
Could not
convert old pen data object. |
Comments
ExtractPenDataPoints extracts points (and OEM data, if any) from a
specified stroke of the pen data object specified by hpndt. It copies
the extracted points and the OEM data to the buffers pointed to by lppt
and lpvOem.
Use ExtractPenDataStrokes to extract strokes from the
pen data object or RemovePenDataStrokes to remove strokes from the pen data object.
See Also