winuser.h


ValidateRect

La función ValidateRect valida el área de cliente dentro de rectángulo eliminandolo de la región de actualización de la ventana especificada.

Sintaxis

BOOL ValidateRect(
    HWND hWnd,            // manipulador de la ventana con la región de actualización modificada  
    CONST RECT * lpRect,  // dirección del rectángulo con las coordenadas
   );

Parámetros:

hWnd: identifica la ventana cuya región de actualización ha cambiado. Si este parámetro es NULL, Windows invalida y redibuja todas las ventanas, y envía los mensajes WM_ERASEBKGND y WM_NCPAINT al procedimiento de ventana antes de que la función regrese.

lpRect: apunta a una estructura RECT que contiene las coordenadas de cliente del rectángulo que se eliminará de la región de actualización. Si este parámetro es NULL, se elimina de la región de actualización toda el área de cliente.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero.

Observaciones

La función BeginPaint valida toda el área de cliente automáticamente. De modo que no es necesario usar ValidateRect ni ValidateRgn si una parte de la región de actualización debe ser validada antes de que se genere el siguiente mensaje WM_PAINT.

Windows continúa generando mensajes WM_PAINT hasta que la región de actualización actual sea validada.