Função PolyPolygon (wingdi.h)

Artigo
08/27/2023

A função PolyPolygon desenha uma série de polígonos fechados. Cada polígono é descrito usando a caneta atual e preenchido usando o modo de preenchimento de pincel e polígono atual. Os polígonos desenhados por essa função podem se sobrepor.

Sintaxe

BOOL PolyPolygon(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const INT   *asz,
  [in] int         csz
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] apt

Um ponteiro para uma matriz de estruturas POINT que definem os vértices dos polígonos, em coordenadas lógicas. Os polígonos são especificados consecutivamente. Cada polígono é fechado automaticamente desenhando uma linha do último vértice para o primeiro. Cada vértice deve ser especificado uma vez.

[in] asz

Um ponteiro para uma matriz de inteiros, cada um dos quais especifica o número de pontos no polígono correspondente. Cada inteiro deve ser maior ou igual a 2.

[in] csz

O número total de polígonos.

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

A posição atual não é usada nem atualizada por essa função.

Todos os pontos extras são ignorados. Para desenhar os polígonos com mais pontos, divida seus dados em grupos, cada um com menos do que o número máximo de pontos e chame a função para cada grupo de pontos. Observe que é melhor ter um polígono em apenas um dos grupos.

Requisitos

Requisito	Valor
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