Graphics.DrawPolygon(const Pen*, const PointF*, INT*) method

Applies to: desktop apps only

The Graphics::DrawPolygon method draws a polygon.

Syntax

Status DrawPolygon(
  [in]  const Pen *pen,
  [in]  const PointF *points,
  [in]  INT *count
);

Parameters

• pen [in]
  Type: const Pen*

  Pointer to a pen that is used to draw the polygon.

• points [in]
  Type: const PointF*

  Pointer to an array of PointF objects that specify the vertices of the polygon.

• count [in]
  Type: INT*

  Integer that specifies the number of elements in the points array.

Return value

Type:

Type: Status****

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Remarks

If the first and last coordinates in the points array are not identical, a line is drawn between them to close the polygon.

Examples

The following example draws a polygon, defined by an array of points.

VOID Example_DrawPolygon2(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Pen object.
   Pen blackPen(Color(255, 0, 0, 0), 3);

   // Create an array of PointF objects that define the polygon.
   PointF point1(100.0f, 100.0f);
   PointF point2(200.0f, 130.0f);
   PointF point3(150.0f, 200.0f);
   PointF point4(50.0f, 200.0f);
   PointF point5(0.0f, 130.0f);
   PointF points[5] = {point1, point2, point3, point4, point5};
   PointF* pPoints = points;

   // Draw the polygon.
   graphics.DrawPolygon(&blackPen, pPoints, 5);
}

Requirements

See also

Graphics

FillPolygon Methods

PointF

Polygons

Send comments about this topic to Microsoft

Build date: 3/6/2012