Funzione GetUpdateRect (winuser.h)

Articolo
08/27/2023

La funzione GetUpdateRect recupera le coordinate del rettangolo più piccolo che racchiude completamente l'area di aggiornamento della finestra specificata. GetUpdateRect recupera il rettangolo in coordinate logiche. Se non è presente alcuna area di aggiornamento, GetUpdateRect recupera un rettangolo vuoto (imposta tutte le coordinate su zero).

Sintassi

BOOL GetUpdateRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect,
  [in]  BOOL   bErase
);

Parametri

[in] hWnd

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

[out] lpRect

Puntatore alla struttura RECT che riceve le coordinate, in unità di dispositivo, del rettangolo di inclusione.

Un'applicazione può impostare questo parametro su NULL per determinare se esiste un'area di aggiornamento per la finestra. Se questo parametro è NULL, GetUpdateRect restituisce un valore diverso da zero se esiste un'area di aggiornamento e zero in caso contrario. In questo modo è possibile determinare se un messaggio di WM_PAINT è stato generato da un'area non valida.

[in] bErase

Specifica se lo sfondo nell'area di aggiornamento deve essere cancellato. Se questo parametro è TRUE e l'area di aggiornamento non è vuota, GetUpdateRect invia un messaggio WM_ERASEBKGND alla finestra specificata per cancellare lo sfondo.

Valore restituito

Se l'area di aggiornamento non è vuota, il valore restituito è diverso da zero.

Se non è presente alcuna area di aggiornamento, il valore restituito è zero.

Commenti

Il rettangolo di aggiornamento recuperato dalla funzione BeginPaint è identico a quello recuperato da GetUpdateRect.

BeginPaint convalida automaticamente l'area di aggiornamento, quindi qualsiasi chiamata a GetUpdateRect effettuata immediatamente dopo la chiamata a BeginPaint recupera un'area di aggiornamento vuota.

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)