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).
See Also