InsertPenDataPoints
2.0
Inserts
points into an existing HPENDATA object.
int InsertPenDataPoints( HPENDATA hpndt,
UINT iStrk, UINT iPnt, UINT cPnts, LPPOINT
lppt, LPVOID lpvOem )
Parameters
hpndt
Handle to an HPENDATA
object.
iStrk
Zero-based
index of the stroke into which the points are inserted. If this value is
IX_END, the points are inserted in the last stroke.
iPnt
Zero-based
index of the point in the stroke before which the points are inserted. If this
value is IX_END, the points are appended to the end of the stroke.
cPnts
Total number
of points to be inserted. If this is 0, the function returns PDR_OK without
taking any other action.
lppt
Address of an
array of POINT
structures containing the points to be inserted.
lpvOem
Address of a
buffer containing the OEM data to be inserted. This value can be NULL only if
the HPENDATA object does not have OEM data or a PENINFO structure.
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
InsertPenDataPoints inserts points into an existing stroke of the
specified pen data object. It does not create a new stroke. (Use the InsertPenDataStroke function to insert new
strokes into the pen data object.) The stroke attributes are not affected by
the points added to the stroke.
The calling
application must ensure that lppt and lpvOem are valid and that
the points are in the same scale as those of the pen data object. InsertPenDataPoints
performs no automatic scaling of the points.
InsertPenDataPoints does not make any timing adjustments after adding
points. This can affect recognition accuracy and should be used judiciously.
For a
description of timing information, see The HINKSET Object in Chapter 4, The
Inking Process.
See Also