Función GetUpdateRgn (winuser.h)
La función GetUpdateRgn recupera la región de actualización de una ventana copiándola en la región especificada. Las coordenadas de la región de actualización son relativas a la esquina superior izquierda de la ventana (es decir, son coordenadas de cliente).
Sintaxis
int GetUpdateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
Parámetros
[in] hWnd
Controle la ventana con una región de actualización que se va a recuperar.
[in] hRgn
Identificador de la región para recibir la región de actualización.
[in] bErase
Especifica si se debe borrar el fondo de la ventana y si se deben dibujar áreas no cliente de ventanas secundarias. Si este parámetro es FALSE, no se realiza ningún dibujo.
Valor devuelto
El valor devuelto indica la complejidad de la región resultante; puede ser uno de los valores siguientes.
| Value | Significado |
|---|---|
| COMPLEXREGION | La región consta de más de un rectángulo. |
| ERROR | Se produjo un error. |
| NULLREGION | La región está vacía. |
| SIMPLEREGION | La región es un único rectángulo. |
Comentarios
La función BeginPaint valida automáticamente la región de actualización, por lo que cualquier llamada a GetUpdateRgn realizada inmediatamente después de la llamada a BeginPaint recupera una región de actualización vacía.
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-0 (introducido en Windows 8) |