winuser.h


GetUpdateRect

La función GetUpdateRect recupera las coordenadas del rectángulo más pequeño que contiene por completo la región de actualización de la ventana especificada. Si la ventana fue creada con el estilo CS_OWNDC y el modo de mapeo no es MM_TEXT, GetUpdateRect recupera el rectángulo en coordenadas lógicas. En otro caso, lo recupera en coordenadas de cliente. Si no existe región de actualización, GetUpdateRect devuelve un rectángulo vacío (con todas las coordenadas a cero).

Sintaxis

BOOL GetUpdateRect(
    HWND hWnd,      // manipulador de ventana
    LPRECT lpRect,  // dirección con coordenadas del rectángulo de actualización
    BOOL bErase     // bandera de borrado
   );

Parámetros:

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

lpRect: apunta a una estructura RECT que recibirá las coordenadas del rectángulo que contiene la región.

Se puede usar un parámetro NULL para averiguar si la ventana tiene una región de actualización. Si este parámetro es NULL, GetUpdateRect devuelve un valor distinto de cero si existe una región de actualización, y cero si no existe. Esto proporciona una forma sencilla y eficiente de determinar si el mensaje WM_PAINT proviene de un área inválida.

bErase: especifica si el fondo de la región de actualización debe ser borrado. Si este parámetro es TRUE y la región de actualización no está vacía, GetUpdateRect envía un mensaje WM_ERASEBKGND a la ventana especificada para que borre el fondo.

Valor de retorno

Si la región no está vacía, el valor de retorno es distinto de cero.

Si no hay región de actualización, el valor de retorno es cero.

Observaciones

El rectángulo de actualización recuperado por la función BeginPaint es idéntico al recuperado por GetUpdateRect.

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