Index   Commented   Search   About

Creating an HPENDATA Object

The Pen API provides five functions that allocate and free an HPENDATA object. These functions are similar to many Windows data types.

Note It is recommended that you use only the functions from version 2.0 of the Pen API. Although API from version 1.0 are included for backward compatibility, it is not guaranteed that they will be supported in future versions of the Pen API.

The functions that allocate and free HPENDATA objects are as follows:

Function
Description
CreatePenData
Creates an empty HPENDATA object. The application provides the PENINFO structure for the header, the real size of any OEM data stored with each coordinate, and the scale of the coordinates. Superseded by CreatePenDataEx.
CreatePenDataEx
Creates an empty HPENDATA object. This function is an enhanced version of CreatePenData that provides an application with greater control over the contents of the HPENDATA object.
CreatePenDataHRC
Returns a handle to an HPENDATA object copied from an HRC object. Since this call creates a new HPENDATA, the application should free the object when finished by calling DestroyPenData, described below. The AddPenDataHRC function reverses the process by copying pen data to an HRC object. Chapter 5, "The Recognition Process," describes the HRC object.
DuplicatePenData
Duplicates an HPENDATA object, allowing an application to create clones of existing pen data. Since this call creates a new HPENDATA, the application should free the object when finished by calling DestroyPenData, described below.
DestroyPenData
Frees the heap memory occupied by the HPENDATA block. If the function returns TRUE, the handle to the object is no longer valid and should be set to NULL.

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
TMS Scripter Studio Pro components for Delphi/C++Builder

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

Free Tech Secrets ;) Copyright © 2008 Free Tect Secrets ;) greatis just4fun network just4fun