|
BeginEnumStrokes
- 0 2.0
Locks a pen data block in memory in preparation for enumerating strokes.
Note This function is provided only for compatibility with version 1.0 of the Pen
API, and will not be supported in future versions.
LPPENDATA BeginEnumStrokes( HPENDATA hpendata )
Parameters
hpendata
Handle to an HPENDATA object.
Return Value
Returns a pointer to the locked pen data if successful. Returns NULL if hpendata is compressed or if the handle cannot be locked.
Comments
BeginEnumStrokes calls the GlobalLock function internally, returning a far pointer to the memory block in the
global heap. This serves to lock the data in preparation for direct reading or
calling GetPenDataStroke. The return value from BeginEnumStrokes is used as an argument for GetPenDataStroke. After calling BeginEnumStrokes to lock data, an application must unlock the data when finished by calling EndEnumStrokes.
An application should never modify data directly within an HPENDATA block. Doing so can invalidate other information in the block. To modify an HPENDATA block, use one of the Pen API functions listed in Chapter 4, "The Inking
Process."
See Also
EndEnumStrokes, GetPenDataStroke
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
|
