InsertPenDataStroke
2.0
Inserts a
stroke into an existing HPENDATA object.
int InsertPenDataStroke( HPENDATA hpndt,
UINT iStrk, LPPOINT lppt, LPVOID lpvOem,
LPSTROKEINFO lpsiNew )
Parameters
hpndt
Handle to the
HPENDATA object that receives the inserted strokes.
iStrk
Zero-based
index of the stroke at which the new stroke is to be inserted. If this value is
IX_END, the stroke is appended at the end of the HPENDATA memory block.
lppt
Pointer to a
buffer containing the points to be inserted.
lpvOem
Pointer to a
buffer of OEM data. This value can be NULL only if the pen data object does not
have OEM data or a PENINFO
structure.
lpsiNew
Pointer to
the STROKEINFO
structure containing information about the stroke.
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_TIMESTAMPERR |
Timing
error. |
|
PDR_VERSIONERR |
Could not
convert old pen data object. |
Comments
InsertPenDataStroke inserts an entire stroke into an HPENDATA
object. Use InsertPenDataPoints to insert points into a particular stroke.
The inserted
stroke assumes the default pen-tip attributes. SetStrokeAttributes should be called after
inserting the stroke to change such stroke attributes as the pen-tip
characteristics or user data.
The calling
application must ensure that lppt and lpvOem are valid, and that
the points in the stroke that is being added have compatible scaling modes.
Attempting to
insert an empty stroke simply returns PDR_OK.
See Also