Funzione InvalidateRect (winuser.h)

Articolo
08/27/2023

La funzione InvalidateRect aggiunge un rettangolo all'area di aggiornamento della finestra specificata. L'area di aggiornamento rappresenta la parte dell'area client della finestra che deve essere ridisegnata.

Sintassi

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

Parametri

[in] hWnd

Handle della finestra di cui è stata modificata l'area di aggiornamento. Se questo parametro è NULL, il sistema invalida e ridisegna tutte le finestre, non solo le finestre per questa applicazione e invia il WM_ERASEBKGND e WM_NCPAINT messaggi prima che la funzione restituisca. Non è consigliabile impostare questo parametro su NULL .

[in] lpRect

Puntatore a una struttura RECT che contiene le coordinate client del rettangolo da aggiungere all'area di aggiornamento. Se questo parametro è NULL, l'intera area client viene aggiunta all'area di aggiornamento.

[in] bErase

Specifica se lo sfondo all'interno dell'area di aggiornamento deve essere cancellato quando viene elaborata l'area di aggiornamento. Se questo parametro è TRUE, lo sfondo viene cancellato quando viene chiamata la funzione BeginPaint . Se questo parametro è FALSE, lo sfondo rimane invariato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Le aree invalidate si accumulano nell'area di aggiornamento fino a quando l'area non viene elaborata quando si verifica il messaggio di WM_PAINT successivo o fino a quando l'area non viene convalidata usando la funzione ValidateRect o ValidateRgn .

Il sistema invia un messaggio di WM_PAINT a una finestra ogni volta che l'area di aggiornamento non è vuota e non sono presenti altri messaggi nella coda dell'applicazione per tale finestra.

Se il parametro bErase è TRUE per qualsiasi parte dell'area di aggiornamento, lo sfondo viene cancellato nell'intera area, non solo nella parte specificata.

Esempio

Per un esempio, vedere Invalidamento dell'area client.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-draw-l1-1-0 (introdotto in Windows 8)