Funzione ValidateRgn (winuser.h)

Articolo
03/13/2024

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 ValidateRect né ValidateRgn 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)