Polygon function (wingdi.h)

Article
02/22/2024

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 *apt,
  [in] int         cpt
);

Parameters

[in] hdc

A handle to the device context.

[in] apt

A pointer to an array of POINT structures that specify the vertices of the polygon, in logical coordinates.

[in] cpt

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

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wingdi.h (include Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll