Função polygon (wingdi.h)

Artigo
03/08/2023

A função Polygon desenha um polígono que consiste em dois ou mais vértices conectados por linhas retas. O polígono é descrito usando a caneta atual e preenchido usando o pincel atual e o modo de preenchimento de polígono.

Sintaxe

BOOL Polygon(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] int         cpt
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] apt

Um ponteiro para uma matriz de estruturas POINT que especificam os vértices do polígono, em coordenadas lógicas.

[in] cpt

O número de vértices na matriz. Esse valor deve ser maior ou igual a 2.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

O polígono é fechado automaticamente desenhando uma linha do último vértice para o primeiro.

A posição atual não é usada nem atualizada pela função Polygon .

Todos os pontos extras são ignorados. Para desenhar uma linha com mais pontos, divida seus dados em grupos, cada um deles com menos do que o número máximo de pontos e chame a função para cada grupo de pontos. Lembre-se de conectar os segmentos de linha.

Requisitos


Cliente mínimo com suporte	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	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll