Método Graphics::D rawPolygon(constPen,constPointF,INT) (gdiplusgraphics.h)

Artigo
08/24/2023

O método Graphics::D rawPolygon desenha um polígono.

Sintaxe

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

Parâmetros

pen

Ponteiro para uma caneta usada para desenhar o polígono.

points

Ponteiro para uma matriz de objetos PointF que especificam os vértices do polígono.

count

Inteiro que especifica o número de elementos na matriz de pontos .

Valor retornado

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Se a primeira e a última coordenadas na matriz de pontos não forem idênticas, uma linha será desenhada entre elas para fechar o polígono.

Exemplos

O exemplo a seguir desenha um polígono, definido por uma matriz de pontos.

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);
}