Condividi tramite


Funzione GetUpdateRect (winuser.h)

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)

Vedi anche

Beginpaint

GetUpdateRgn

InvalidateRect

Funzioni di disegno e disegno

Panoramica di disegno e disegno

RECT

UpdateWindow

ValidateRect