|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| gdi32.lib
| Header File
| wingdi.h
| Unicode
| No
| Platform Notes
| Windows 95: 16-bit coordinates only
|
|
|
GetPath
The GetPath function retrieves the coordinates defining the endpoints of lines and the
control points of curves found in the path that is selected into the specified
device context.
int GetPath(
HDC hdc,
| // handle of device context
| LPPOINT lpPoints,
| // address of array receiving path vertices
| LPBYTE lpTypes,
| // address of array of path vertex types
| int nSize
| // count of points defining path
| );
|
|
Parameters
hdc
Identifies a device context that contains a closed path.
lpPoints
Points to an array of POINT structures that contains the line endpoints and curve control points.
lpTypes
Points to an array of bytes where the vertex types are placed. Values are one
of the following:
Type
| Description
| PT_MOVETO
| Specifies that the corresponding point in the lpPoints parameter starts a disjoint figure.
| PT_LINETO
| Specifies that the previous point and the corresponding point in lpPoints are the endpoints of a line.
| PT_BEZIERTO
| Specifies that the corresponding point in lpPoints is a control point or ending point for a Bézier curve.
|
| PT_BEZIERTO values always occur in sets of three. The point in the path
immediately preceding them defines the starting point for the Bézier curve. The first
two PT_BEZIERTO points are the control points, and the third PT_BEZIERTO point
is the ending (if hard-coded) point.
|
A PT_LINETO or PT_BEZIERTO value may be combined with the following value (by
using the bitwise operator OR) to indicate that the corresponding point is the
last point in a figure and the figure should be closed:
Flag
| Description
| PT_CLOSEFIGURE
| Specifies that the figure is automatically closed after the corresponding line
or curve is drawn. The figure is closed by drawing a line from the line or
curve endpoint to the point corresponding to the last PT_MOVETO.
|
nSize
Specifies the total number of POINT structures that may be placed in the array pointed to by lpPoints. This value must be the same as the number of bytes that may be placed in the
array pointed to by lpTypes.
Return Values
If the nSize parameter is nonzero, the return value is the number of points enumerated. If nSize is 0, the return value is the total number of points in the path (and GetPath writes nothing to the buffers). If nSize is nonzero and is less than the number of points in the path, the return
value is  1. To get extended error information, call GetLastError. GetLastError may return one of the following error codes:
ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_BUFFER_OVERFLOW
Remarks
The device context identified by the hdc parameter must contain a closed path.
The points of the path are returned in logical coordinates. Points are stored
in the path in device coordinates, so GetPath changes the points from device coordinates to logical coordinates by using
the inverse of the current transformation.
The FlattenPath function may be called before GetPath to convert all curves in the path into line segments.
See Also
FlattenPath, POINT, PolyDraw, WidenPath
| 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
|
