Función ValidateRect (winuser.h)
La función ValidateRect valida el área de cliente dentro de un rectángulo quitando el rectángulo de la región de actualización de la ventana especificada.
Sintaxis
BOOL ValidateRect(
[in] HWND hWnd,
[in] const RECT *lpRect
);
Parámetros
[in] hWnd
Identificador de la ventana cuya región de actualización se va a modificar. Si este parámetro es NULL, el sistema invalida y vuelve a dibujar todas las ventanas y envía el WM_ERASEBKGND y WM_NCPAINT mensajes al procedimiento de ventana antes de que la función devuelva.
[in] lpRect
Puntero a una estructura RECT que contiene las coordenadas de cliente del rectángulo que se van a quitar de la región de actualización. Si este parámetro es NULL, se quita todo el área de cliente.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
La función BeginPaint valida automáticamente todo el área de cliente. No se debe llamar a la función ValidateRect ni ValidateRgn si se debe validar una parte de la región de actualización antes de que se genere el siguiente mensaje de WM_PAINT .
El sistema sigue generando mensajes WM_PAINT hasta que se valide la región de actualización actual.
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) |