Función CreatePolyPolygonRgn (wingdi.h)

Artículo
08/27/2023

La función CreatePolyPolygonRgn crea una región que consta de una serie de polígonos. Los polígonos se pueden superponer.

Sintaxis

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

Parámetros

[in] pptl

Puntero a una matriz de estructuras POINT que definen los vértices de los polígonos en unidades lógicas. Los polígonos se especifican de forma consecutiva. Se supone que cada polígono está cerrado y cada vértice se especifica una sola vez.

[in] pc

Puntero a una matriz de enteros, cada uno de los cuales especifica el número de puntos de uno de los polígonos de la matriz a la que apunta lppt.

[in] cPoly

Número total de enteros de la matriz a la que apunta lpPolyCounts.

[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 cero.

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.

Requisitos

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