Funzione GetUpdateRgn (winuser.h)

  • Articolo

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)

Vedi anche

Funzioni di disegno e disegno

Panoramica di disegno e disegno