Funzione GetUpdateRgn (winuser.h)
La funzione GetUpdateRgn recupera l'area di aggiornamento di una finestra copiandola nell'area specificata. Le coordinate dell'area di aggiornamento sono relative all'angolo superiore sinistro della finestra, ovvero sono coordinate client.
Sintassi
int GetUpdateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
Parametri
[in] hWnd
Gestire nella finestra con un'area di aggiornamento da recuperare.
[in] hRgn
Gestire l'area per ricevere l'area di aggiornamento.
[in] bErase
Specifica se lo sfondo della finestra deve essere cancellato e se devono essere disegnate aree non client di finestre figlio. Se questo parametro è FALSE, non viene eseguito alcun disegno.
Valore restituito
Il valore restituito indica la complessità dell'area risultante; può essere uno dei valori seguenti.
| Valore | Significato |
|---|---|
| COMPLEXREGION | L'area è costituita da più rettangoli. |
| ERRORE | Si è verificato un errore. |
| NULLREGION | L'area è vuota. |
| SIMPLEREGION | Region è un singolo rettangolo. |
Commenti
La funzione BeginPaint convalida automaticamente l'area di aggiornamento, pertanto qualsiasi chiamata a GetUpdateRgn 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) |