Compartir a través de


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

Consulte también

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

Funciones de región

Información general sobre regiones

SelectObject