Función GetWindowRgn (winuser.h)
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 |
|---|---|
|
La región está vacía. |
|
La región es un único rectángulo. |
|
La región es más de un rectángulo. |
|
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) |