Funzione ValidateRgn (winuser.h)

La funzione ValidateRgn convalida l'area client all'interno di un'area rimuovendo l'area dell'aggiornamento corrente della finestra specificata.

Sintassi

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

Parametri

[in] hWnd

Gestire nella finestra la cui area di aggiornamento deve essere modificata.

[in] hRgn

Gestire in un'area che definisce l'area da rimuovere dall'area di aggiornamento. Se questo parametro è NULL, l'intera area client viene rimossa.

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

L'area specificata deve essere stata creata da una funzione area. Si presuppone che le coordinate dell'area siano coordinate client.

La funzione BeginPaint convalida automaticamente l'intera area client. Non è necessario chiamare né la funzione ValidateRectValidateRgn se una parte dell'area di aggiornamento deve essere convalidata prima che venga generato il messaggio di WM_PAINT successivo.

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)

Vedi anche

Beginpaint

ExcludeUpdateRgn

InvalidateRect

InvalidateRgn

Funzioni di disegno e disegno

Panoramica di disegno e disegno

ValidateRect

WM_PAINT