Compartir a través de


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)

Consulte también

BeginPaint

InvalidateRect

InvalidateRgn

Funciones de dibujo y dibujo

Información general sobre pintura y dibujo

RECT

ValidateRgn

WM_PAINT