|
DrawPenData
- 0 2.0
Displays the pen data in an HPENDATA object as a trail of visible ink.
DrawPenData( HDC hdc, LPRECT lprect, HPENDATA hpndt )
Parameters
hdc
Handle to a device context. This parameter can also be the handle of a
metafile.
lprect
Bounding rectangle of ink, in client coordinates. Can be NULL.
hpndt
Handle to a pen data object.
Return Value
This function does not return a value. If hpndt is NULL, DrawPenData does nothing.
Comments
DrawPenData draws the pen data in the specified device context using the GDI Polyline function. The current settings in the device context rather than the ink
characteristics determine how the data is rendered. This means the ink width and
color specified in the PENDATAHEADER structure have no effect on how DrawPenData renders the ink. To alter the display characteristics of the ink, an
application must call the appropriate Windows GDI functions to set the GDI drawing pen
(not to be confused with the real pen).
The application using DrawPenData must either scale the data points or set the mapping appropriately if lprect is NULL.
If lprect is not NULL, the points are scaled into lprect as the drawing is done. Internally, nondestructive calls to the SetViewportExtEx, SetViewPortOrg, SetWindowOrg, and SetWindowExtEx functions are used to render the pen data in the device context within the
bounds of the provided rectangle. An application must compute the proper pen
width (if it is other than 1) before calling this function with a valid lprect parameter to account for the scaling that occurs.
DrawPenData draws the ink in the rectangle relative to the upper-left corner of the
window. It ignores any changes that have been made to the origin of the device
context by previous calls to the SetWindowOrg or SetViewportOrgEx functions. If the origin has changed, the rectangle passed to DrawPenData must be offset by the appropriate amount.
If the ink is to be drawn with a width of greater than 1 pixel, the width of
the currently selected pen must be set to achieve the desired result. The width
must be set in client coordinates if a mapping mode is set in the device
context. For example, if the mapping mode has been set to MM_HIENGLISH, the pen width
must be set to a number appropriate for the desired width in MM_HIENGLISH
units to preserve the proper scale of the ink. This scaling is only an issue when
the ink width is greater than 1.
The rendering of the ink data produced by DrawPenData generally does not exactly match the rendering produced by the display driver
when the data was first collected. This discrepancy results because DrawPenData and the Polyline function use different algorithms to draw the data. The difference is an
occasional "off by one" error that appears as a shifting of some pixels around the
edges, depending on the rounding done by Polyline. An application that requires an exact replication of the original ink
rendering should call the RedisplayPenData function.
The DrawPenDataEx function allows more control when drawing the contents of pen structures.
See Also
CreatePenData, DrawPenDataEx, DuplicatePenData, RedisplayPenData
| 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
|
