Función CreatePolygonRgn (wingdi.h)

Artículo
08/27/2023

La función CreatePolygonRgn crea una región poligonal.

Sintaxis

HRGN CreatePolygonRgn(
  [in] const POINT *pptl,
  [in] int         cPoint,
  [in] int         iMode
);

Parámetros

[in] pptl

Puntero a una matriz de estructuras POINT que definen los vértices del polígono en unidades lógicas. Se supone que el polígono está cerrado. Cada vértice solo se puede especificar una vez.

[in] cPoint

Número de puntos de la matriz.

[in] iMode

Modo de relleno que se usa para determinar qué píxeles están en la región. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
ALTERNATIVO	Selecciona el modo alternativo (rellena el área entre los lados del polígono impar e incluso numerado en cada línea de examen).
BOBINA	Selecciona el modo de desenlazamiento (rellena cualquier región con un valor de viento distinto de cero).

Para obtener más información sobre estos modos, vea la función SetPolyFillMode .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el identificador de la región.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Cuando ya no necesite el objeto HRGN , llame a la función DeleteObject para eliminarlo.

Las coordenadas de región se representan como enteros con signo de 27 bits.

Las regiones creadas por los métodos Create<shape>Rgn (como CreateRectRgn y CreatePolygonRgn) solo incluyen el interior de la forma; el contorno de la forma se excluye de la región. Esto significa que cualquier punto de una línea entre dos vértices secuenciales no se incluye en la región. Si fuera a llamar a PtInRegion para este punto, devolvería cero como resultado.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll