Función GetWindowRgnBox (winuser.h)

Artículo
03/15/2023

La función GetWindowRgnBox recupera las dimensiones del rectángulo delimitador más ajustado para la región de ventana de una ventana.

Sintaxis

int GetWindowRgnBox(
  [in]  HWND   hWnd,
  [out] LPRECT lprc
);

Parámetros

[in] hWnd

Identificador de la ventana.

[out] lprc

Puntero a una estructura RECT que recibe las dimensiones del rectángulo, en unidades de dispositivo relativas a la esquina superior izquierda 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.

Value	Significado
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.
NULLREGION	La región está vacía.
SIMPLEREGION	La región es un único rectángulo.

Comentarios

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. 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 .

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	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-draw-l1-1-0 (introducido en Windows 8)