winuser.h


GetWindowRgn

La función GetWindowRgn obtiene una copia de la región de ventana de una ventana. La región de ventana de una ventana se asigna mediante una llamada a la función SetWindowRgn. La región de ventana determina el área dentro de una ventana donde el sistema operativo permite dibuja. El sistema operativo no muestra ninguna porción de una ventana que quede fuera de la región de ventana.

Sintaxis

int GetWindowRgn(
    HWND hWnd,  // manipulador de ventana cuya región se va a obtener
    HRGN hRgn   // manipulador de región que recibe una copia de la región de ventana
   );

Parámetros:

hWnd: manipulador de ventana cuya región de ventana se va a obtener.

hRgn: manipuladr de región. Esta región recibe una copia de la región de ventana.

Valor de retorno

El valor de retorno especifica el tipo de región que la función ha obtenido. Puede ser uno de los siguientes valores:

Valor Significado
NULLREGION La región está vacía.
SIMPLEREGION La región es un rectángulo.
COMPLEXREGION La región es más de un rectángulo.
ERROR Ha ocurrido un error. La región no se ve afectada.

Observaciones

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

Para asignar la región de ventana de una ventana, llamar a la función SetWindowRgn.