Función ValidateRect (winuser.h)

Artículo
08/28/2023

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)