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