|
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
AddPointsPenData, ExtractPenDataPoints, InsertPenDataPoints, RemovePenDataStrokes, STROKEINFO
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
|
