DrawPenDataFmt

2.0

The DrawPenDataFmt macro is used to draw pen data using its stored stroke attributes.

int DrawPenDataFmt( HDC hdc, LPRECT lprectVP, HPENDATA hpndt )

Parameters
hdc

Handle to a device context.

lprectVP

Viewport rectangle, usually the bounding rectangle of the HPENDATA object, in client coordinates. The ink is scaled to fit the specified rectangle. If this parameter is NULL, the bounding rectangle of the ink in hpndt is used, in whatever coordinate system it happens to be in.

hpndt

Handle to an HPENDATA object.

Return Value
Returns PDR_OK if successful. Attempting to draw valid but empty pen data (containing no strokes) also returns PDR_OK. Otherwise, the return value is one of the following:

Constant	Description
PDR_COMPRESSED	Pen data is compressed.
PDR_ERROR	Invalid sampling rate (0 or less) in pen data header, or other error.
PDR_MEMERR	Memory error.
PDR_PNDTERR	Invalid pen data.
PDR_VERSIONERR	Could not convert old pen data.

Comments
The DrawPenDataFmt macro is a wrapper for DrawPenDataEx, providing default values for most of the parameters.

The definition is:

#define DrawPenDataFmt( hdc, lprectVP, hpndt )

DrawPenDataEx( hdc, lprectVP, hpndt, 0, IX_END, 0, IX_END, NULL,

NULL, 0 );

These default values specify:

Full-speed rendering (no animation).
Entire data set is drawn (no stroke subsets).