Función InvalidateRect (winuser.h)

Artículo
08/27/2023

La función InvalidateRect agrega un rectángulo a la región de actualización de la ventana especificada. La región de actualización representa la parte del área de cliente de la ventana que se debe volver a dibujar.

Sintaxis

BOOL InvalidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect,
  [in] BOOL       bErase
);

Parámetros

[in] hWnd

Identificador de la ventana cuya región de actualización ha cambiado. Si este parámetro es NULL, el sistema invalida y vuelve a dibujar todas las ventanas, no solo las ventanas de esta aplicación, y envía el WM_ERASEBKGND y WM_NCPAINT mensajes antes de que la función devuelva. No se recomienda establecer este parámetro en NULL .

[in] lpRect

Puntero a una estructura RECT que contiene las coordenadas de cliente del rectángulo que se van a agregar a la región de actualización. Si este parámetro es NULL, se agrega todo el área de cliente a la región de actualización.

[in] bErase

Especifica si el fondo dentro de la región de actualización debe borrarse cuando se procesa la actualización de la región. Si este parámetro es TRUE, se borra el fondo cuando se llama a la función BeginPaint . Si este parámetro es FALSE, el fondo permanece sin cambios.

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

Las áreas invalidadas se acumulan en la región de actualización hasta que la región se procesa cuando se produce el siguiente mensaje de WM_PAINT o hasta que la región se valida mediante la función ValidateRect o ValidateRgn .

El sistema envía un mensaje de WM_PAINT a una ventana cada vez que su región de actualización no está vacía y no hay otros mensajes en la cola de la aplicación para esa ventana.

Si el parámetro bErase es TRUE para cualquier parte de la región de actualización, el fondo se borra en toda la región, no solo en el elemento especificado.

Ejemplos

Para obtener un ejemplo, consulte Invalidación del área de cliente.

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 (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-draw-l1-1-0 (introducido en Windows 8)