PENDATAHEADER 

1.0    2.0     

Main header of an HPENDATA memory block.

typedef struct { 

     UINT wVersion;

     UINT cbSizeUsed;

     UINT cStrokes;

     UINT cPnt;

     UINT cPntStrokeMax;

     RECT rectBound;

     UINT wPndts;

     int nInkWidth;

     DWORD rgbInk;

} PENDATAHEADER;

Members

wVersion

Pen data format version. Same as the version number for the Pen API, which is currently 0x0002. Calling GetPenDataAttributes1AOBX_ with the GPA_VERSION argument retrieves the value of wVersion.

cbSizeUsed

Size (in bytes) of pen data memory block.

cStrokes

Number of strokes in the block. (Each pen-down and pen-up sequence counts as a single stroke.)

cPnt

Count of all points in the block. Calling GetPenDataAttributes with the GPA_POINTS argument retrieves the value of cPnt.

cPntStrokeMax

Length (in points) of longest stroke. Calling GetPenDataAttributes1AOBX_ with the GPA_MAXLEN argument retrieves the value of cPntStrokeMax.

rectBound

Bounding rectangle of all pen-down points.

wPndts

Data scaling metric value, expressed as a bitwise-OR combination of PDTS_ values.

nInkWidth

Ink width, in pixels.

rgbInk

Ink color.

Comments

The PENDATAHEADER structure describes the contents of an HPENDATA memory block. Use the GetPenDataInfo232HAHC or GetPenDataAttributes1AOBX_ function to retrieve information from a PENDATAHEADER structure.

For a description of the HPENDATA memory block, see  The HPENDATA Object  in Chapter 4,  The Inking Process. 

For a list of data scaling values, refer to the entry for PDTS_ values in Chapter 13,  Pen Application Programming Interface Constants. 

See Also