|
CreatePenDataEx
- 0
Creates a PENDATA structure with specified OEM data subsets.
HPENDATA CreatePenDataEx( LPPENINFO lppeninfo, UINT uScale, UINT fuOptions, UINT gmemFlags )
Parameters
lppeninfo
Address of tablet information to be inserted into the PENINFO structure in the pen data header. If this parameter is NULL, the current
tablet settings are retrieved from the hardware instead. If there is no tablet, the
pendata will not have an embedded PENINFO section and the wPndts member in PENDATAHEADER will have the PDTS_NOPENINFO flag set.
uScale
Data-scaling metric value. This parameter can be one of the following values:
Constant
| Description
| PDTS_LOMETRIC
| Each logical unit is mapped to 0.1 millimeter. Positive x is to the right;
positive y is down.
| PDTS_HIMETRIC
| Each logical unit is mapped to 0.01 millimeter. Positive x is to the right;
positive y is down.
| PDTS_HIENGLISH
| Each logical unit is mapped to 0.001 inch. Positive x is to the right;
positive y is down.
| PDTS_ARBITRARY
| The application has done its own scaling of the data point.
| PDTS_STANDARDSCALE
| The standard scaling metric is equivalent to PDTS_HIENGLISH.
|
fuOptions
Storage and trim options. If this parameter is 0, no timing, PDK_, or OEM data
is stored. If it is CPD_DEFAULT, everything but user data is stored.
Otherwise, this parameter can explicitly specify subsets of OEM and other
data. To do so, the parameter should be a combination of one of the CPD_USER values
that allocate extra storage and any collection of PHW_ constants. (These
values should be combined using the bitwise-OR operator.)
The following table lists the PHW_ values for the fuOptions parameter:
Constant
| Description
| PHW_PRESSURE
| Report pressure in OEM data if available.
| PHW_HEIGHT
| Report height in OEM data if available.
| PHW_ANGLEXY
| Report XY-angle in OEM data if available.
| PHW_ANGLEZ
| Report Z-angle in OEM data if available.
| PHW_BARRELROTATION
| Report barrel rotation in OEM data if available.
| PHW_OEMSPECIFIC
| Report OEM-specific value in OEM data if available.
| PHW_PDK
| Report per-point PDK_ bits in OEM data.
| PHW_ALL
| Report all available OEM data. This flag is the sum of all other PHW_ flags.
The following table lists the CPD_ values for the fuOptions parameter:
| CPD_DEFAULT
| Store timing, PDK, and all OEM data for each stroke.
| CPD_USERBYTE
| Set internal flag to add space for one byte of additional storage to be
allocated for each stroke. Added space is for application use.
| CPD_USERWORD
| Set internal flag to add space for one word of additional storage to be
allocated for each stroke. Added space is for application use.
| CPD_USERDWORD
| Set internal flag to add space for one doubleword of additional storage to be
allocated for each stroke. Added space is for application use.
| CPD_TIME
| Maintain absolute time information for each stroke.
|
gmemFlags
Flag that specifies whether GlobalAlloc should create a shared memory object or not when the pen data object is
created. This should be either 0 or GMEM_DDESHARE. The GMEM_MOVEABLE and
GMEM_ZEROINIT flags are added to this value, and other GMEM_ flags are ignored.
Return Value
Returns the handle to the HPENDATA object if successful; otherwise, returns NULL.
Comments
CreatePenDataEx is an extension of CreatePenData that allows a more detailed specification of what is stored in each stroke of
the pen data.
The fuOptions parameter is typically specified as CPD_DEFAULT to request collection and
storage of all information generated by the tablet, including x-y data, absolute
stroke timing information, and all available OEM data. The OEM data set that is
actually stored in the pen data is the minimum set that satisfies both the
request and what is physically available from the tablet (that is, intersection
set).
If lppeninfo is NULL, and if there is no tablet on the system (that is, if the SendDriverMessage function fails), the pen data that is created will not have any hardware or
OEM information and a default sampling rate of 100Hz will be used. This case is
similar to removing PENINFO from the header using TrimPenData with a parameter of TPD_PENINFO.
A value of 0 for fuOptions is used to indicate that only coordinate data is required. While recognition
of this type of pen data may suffer, this provides the least complicated type
of pen data.
PHW_ bits can be specified to indicate which OEM values or per-point PDK_ pen
state information is to be collected. Note that, except for PHW_PDK, which is
always valid, this is only a request; if the hardware does not support certain
types of OEM data, that data will be absent.
The uScale parameter specifies scaling values that are also used in the MetricScalePenData function and in the PENDATAHEADER structure member wPndts. The scaling values do not behave in the same way as the Windows scaling
units with similar names. For example, a 1-inch line in MM_HIENGLISH will not
necessarily be an inch long on the screen, because GDI does not know the size of the
monitor. However, with PDTS_HIENGLISH in MetricScalePenData, a line drawn an inch long is actually an inch long.
See Also
CreatePenData, DestroyPenData, PDTS_, PDK_
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
