Função CreatePolyPolygonRgn (wingdi.h)

Artigo
03/04/2024

A função CreatePolyPolygonRgn cria uma região que consiste em uma série de polígonos. Os polígonos podem se sobrepor.

Sintaxe

HRGN CreatePolyPolygonRgn(
  [in] const POINT *pptl,
  [in] const INT   *pc,
  [in] int         cPoly,
  [in] int         iMode
);

Parâmetros

[in] pptl

Um ponteiro para uma matriz de estruturas POINT que definem os vértices dos polígonos em unidades lógicas. Os polígonos são especificados consecutivamente. Cada polígono é presumidamente fechado e cada vértice é especificado apenas uma vez.

[in] pc

Um ponteiro para uma matriz de inteiros, cada um dos quais especifica o número de pontos em um dos polígonos na matriz apontada por lppt.

[in] cPoly

O número total de inteiros na matriz apontada por lpPolyCounts.

[in] iMode

O modo de preenchimento usado para determinar quais pixels estão na região. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
ALTERNATIVO	Seleciona o modo alternativo (preenche a área entre lados de polígono com numeração ímpar e par em cada linha de verificação).
ENROLAMENTO	Seleciona o modo de enrolamento (preenche qualquer região com um valor de enrolamento diferente de zero).

Para obter mais informações sobre esses modos, consulte a função SetPolyFillMode .

Retornar valor

Se a função for bem-sucedida, o valor retornado será o identificador para a região.

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

Comentários

Quando você não precisar mais do objeto HRGN , chame a função DeleteObject para excluí-lo.

As coordenadas de região são representadas como inteiros com sinal de 27 bits.

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