winuser.h


GetUpdateRgn

La función GetUpdateRgn recupera la región de actualización de una ventana copiándola a 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, se trata de coordenadas de cliente).

Sintaxis

int GetUpdateRgn(
    HWND hWnd,   // manipulador de ventana
    HRGN hRgn,   // manipulador de región
    BOOL bErase  // bandera de borrado
   );

Parámetros:

hWnd: identifica la ventana con una región de actualización que se quiere recuperar.

hRgn: identifica la región que recibe la región de actualización.

bErase: especifica si el fondo de la ventana debe ser borrado y si las áreas no de cliente de ventanas hijas deben ser trazadas. Si este parámetro es FALSE, no se realiza ningún trazado.

Valor de retorno

El valor de retorno indica la complejidad de la región resultante; puede tener uno de los siguientes valores:

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

Observaciones

BeginPaint valida automáticamente la región de actualización, de modo que cualquier llamada a GetUpdateRgn hecha inmediatamente después de llamar a BeginPaint recuperará una región de actualización vacía.