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.