Función CreateRectRgn (wingdi.h)

Artículo
03/04/2024

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