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

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

Sintaxe

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

Parâmetros

[in] pen

Tipo: caneta* const

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

[in] points

Tipo: const Point*

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

[in] count

Tipo: INT*

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

Valor retornado

Tipo: Status

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_DrawPolygon(HDC hdc)
{
   Graphics graphics(hdc);

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

   // Create an array of Point objects that define the polygon.
   Point point1(100, 100);
   Point point2(200, 130);
   Point point3(150, 200);
   Point point4(50, 200);
   Point point5(0, 130);
   Point points[5] = {point1, point2, point3, point4, point5};
   Point* pPoints = points;

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

Requisitos

Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Métodos FillPolygon

Elementos gráficos

Ponto

Polígonos