|
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
AddPointsPenData, ExtractPenDataPoints, InsertPenData, InsertPenDataStroke, RemovePenDataStrokes
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
