Función CreateEllipticRgn (wingdi.h)

La función CreateEllipticRgn crea una región elíptica.

Sintaxis

HRGN CreateEllipticRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

Parámetros

[in] x1

Especifica la coordenada x en unidades lógicas, de la esquina superior izquierda del rectángulo delimitador de la elipse.

[in] y1

Especifica la coordenada y en unidades lógicas, de la esquina superior izquierda del rectángulo delimitador de la elipse.

[in] x2

Especifica la coordenada x en unidades lógicas, de la esquina inferior derecha del rectángulo delimitador de la elipse.

[in] y2

Especifica la coordenada y en unidades lógicas, de la esquina inferior derecha del rectángulo delimitador de la elipse.

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.

Un rectángulo delimitador define el tamaño, la forma y la orientación de la región: los lados largos del rectángulo definen la longitud del eje principal de la elipse; los lados cortos definen la longitud del eje secundario de la elipse; y el centro del rectángulo define la intersección de los ejes principal y secundario.

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

Consulte también

CreateEllipticRegnIndirect

DeleteObject

Funciones de región

Información general sobre regiones

SelectObject