Funzione ValidateRect (winuser.h)

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 ValidateRectValidateRgn 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)

Vedi anche

Beginpaint

InvalidateRect

InvalidateRgn

Funzioni di disegno e disegno

Panoramica di disegno e disegno

RECT

ValidateRgn

WM_PAINT