Función GetWindowRgn (winuser.h)

  • Artículo

La función GetWindowRgn obtiene una copia de la región de la ventana de una ventana. La región de la ventana de una ventana se establece mediante una llamada a la función SetWindowRgn . La región de la ventana determina el área dentro de la ventana donde el sistema permite dibujar. El sistema no muestra ninguna parte de una ventana que se encuentra fuera de la región de la ventana.

Sintaxis

int GetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Parámetros

[in] hWnd

Identificador de la ventana cuya región de ventana se va a obtener.

[in] hRgn

Identificador de la región que se modificará para representar la región de la ventana.

Valor devuelto

El valor devuelto especifica el tipo de la región que obtiene la función. Puede ser uno de los siguientes valores.

Código devuelto Descripción
NULLREGION
 La región está vacía.
SIMPLEREGION
 La región es un único rectángulo.
COMPLEXREGION
 La región es más de un rectángulo.
ERROR
 La ventana especificada no tiene una región o se produjo un error al intentar devolver la región.

Comentarios

Las coordenadas de la región de ventana de una ventana son relativas a la esquina superior izquierda de la ventana, no al área cliente de la ventana.

Para establecer la región de la ventana de una ventana, llame a la función SetWindowRgn .

Ejemplos

En el código siguiente se muestra cómo pasar el identificador de una región existente.


HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR) 
{ 
/* hrgn contains window region */ 
}
DeleteObject(hrgn); /* finished with region */

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 winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-draw-l1-1-2 (introducido en Windows 10, versión 10.0.10240)

Consulte también

Funciones de dibujo y dibujo

Información general sobre pintura y dibujo

SetWindowRgn