Polygon function
Applies to: desktop apps only
The Polygon function draws a polygon consisting of two or more vertices connected by straight lines. The polygon is outlined by using the current pen and filled by using the current brush and polygon fill mode.
Syntax
BOOL Polygon( __in HDC hdc, __in const POINT *lpPoints, __in int nCount );
Parameters
- hdc [in]
-
A handle to the device context.
- lpPoints [in]
-
A pointer to an array of POINT structures that specify the vertices of the polygon, in logical coordinates.
- nCount [in]
-
The number of vertices in the array. This value must be greater than or equal to 2.
Return value
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Remarks
The polygon is closed automatically by drawing a line from the last vertex to the first.
The current position is neither used nor updated by the Polygon function.
Any extra points are ignored. To draw a line with more points, divide your data into groups, each of which have less than the maximum number of points, and call the function for each group of points. Remember to connect the line segments.
Requirements
|
Minimum supported client | Windows 2000 Professional |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Filled Shapes Overview
- Filled Shape Functions
- GetPolyFillMode
- POINT
- Polyline
- PolylineTo
- PolyPolygon
- SetPolyFillMode
Send comments about this topic to Microsoft
Build date: 3/7/2012
Since Microsoft dropped documentation support for 9x/Me, they forgot to update the Remark section.
- 4/4/2011
- Henrik Haftmann
Although Polygon() calls are routed to the appropriate GDI driver (mostly: screen or printer),
it can be seen as a macro-like call to PolyPolygon():
BOOL Polygon(HDC dc, const POINT*p, int n) {
return PolyPolygon(dc,p,&n,1);
}
- 4/4/2011
- Henrik Haftmann
