Funzione InvalidateRgn (winuser.h)

Articolo
03/04/2024

La funzione InvalidateRgn invalida l'area client all'interno dell'area specificata aggiungendola all'area di aggiornamento corrente di una finestra. L'area non valida, insieme a tutte le altre aree dell'area di aggiornamento, viene contrassegnata per la pittura quando si verifica il messaggio di WM_PAINT successivo.

Sintassi

BOOL InvalidateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

Parametri

[in] hWnd

Handle della finestra con un'area di aggiornamento da modificare.

[in] hRgn

Handle per l'area da aggiungere all'area di aggiornamento. Si presuppone che l'area abbia coordinate client. 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 il parametro è FALSE, lo sfondo rimane invariato.

Valore restituito

Il valore restituito è sempre diverso da zero.

Commenti

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

Il sistema invia un messaggio 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.

L'area specificata deve essere stata creata usando una delle funzioni dell'area.

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

Requisiti

Requisito	Valore
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)