BeginEnumStrokes

  1. 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

Software for developers
Delphi Components
.Net Components
Software for Android Developers
More information resources
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers
Amazon Categories Database
Browse Nodes Database