Función CreatePolygonRgn (wingdi.h)
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.
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 |