Método GraphicsPath::AddPolygon(constPoint*,INT) (gdipluspath.h)

Artigo
02/29/2024

O método GraphicsPath::AddPolygon adiciona um polígono a esse caminho.

Sintaxe

Status AddPolygon(
  [in] const Point *points,
  [in] INT         count
);

Parâmetros

[in] points

Tipo: const Point*

Ponteiro para uma matriz de pontos que especifica os vértices do polígono.

[in] count

Tipo: INT

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

Retornar valor

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

O método GraphicsPath::AddPolygon é semelhante ao método AddLines . A diferença é que um polígono é uma figura intrinsecamente fechada, mas uma sequência de linhas não é uma figura fechada, a menos que você chame GraphicsPath::CloseFigure. Quando o Windows GDI+ renderiza um caminho, cada polígono nesse caminho é fechado; ou seja, o último vértice do polígono é conectado ao primeiro vértice por uma linha reta.

Exemplos

O exemplo a seguir cria um caminho de objeto GraphicsPath, adiciona um polígono ao caminho e desenha o caminho.

VOID Example_AddPolygon(HDC hdc)
{
   Graphics graphics(hdc); 
 
   Point pts[] = {Point(20, 20),
                  Point(120, 20),
                  Point(120, 70)};

   GraphicsPath path;
   path.AddPolygon(pts, 3);

   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Requisitos

Requisito	Valor
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	gdipluspath.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll