Función CreateRectRgn (wingdi.h)
La función CreateRectRgn crea una región rectangular.
Sintaxis
HRGN CreateRectRgn(
[in] int x1,
[in] int y1,
[in] int x2,
[in] int y2
);
Parámetros
[in] x1
Especifica la coordenada x de la esquina superior izquierda de la región en unidades lógicas.
[in] y1
Especifica la coordenada y de la esquina superior izquierda de la región en unidades lógicas.
[in] x2
Especifica la coordenada x de la esquina inferior derecha de la región en unidades lógicas.
[in] y2
Especifica la coordenada y de la esquina inferior derecha de la región en unidades lógicas.
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.
Ejemplos
Para obtener un ejemplo, consulte Marcadores de dibujo.
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 |