Funzione ValidateRect (winuser.h)

Articolo
03/15/2023

La funzione ValidateRect convalida l'area client all'interno di un rettangolo rimuovendo il rettangolo dall'area di aggiornamento della finestra specificata.

Sintassi

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

Parametri

[in] hWnd

Gestire nella finestra la cui area di aggiornamento deve essere modificata. Se questo parametro è NULL, il sistema invalida e ridisegna tutte le finestre e invia i messaggi di WM_ERASEBKGND e WM_NCPAINT alla routine della finestra prima che la funzione restituisca.

[in] lpRect

Puntatore a una struttura RECT che contiene le coordinate client del rettangolo 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

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.

Il sistema continua a generare messaggi WM_PAINT finché non viene convalidata l'area di aggiornamento corrente.

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)