Funzione GetWindowRgn (winuser.h)

La funzione GetWindowRgn ottiene una copia dell'area della finestra di una finestra. L'area della finestra di una finestra viene impostata chiamando la funzione SetWindowRgn . L'area della finestra determina l'area all'interno della finestra in cui il sistema consente il disegno. Il sistema non visualizza alcuna parte di una finestra che si trova all'esterno dell'area della finestra

Sintassi

int GetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Parametri

[in] hWnd

Handle nella finestra la cui area finestra deve essere ottenuta.

[in] hRgn

Handle nell'area che verrà modificata per rappresentare l'area della finestra.

Valore restituito

Il valore restituito specifica il tipo dell'area ottenuta dalla funzione. Può essere uno dei valori seguenti.

Codice restituito Descrizione
NULLREGION
L'area è vuota.
SIMPLEREGION
L'area è un singolo rettangolo.
COMPLEXREGION
L'area è più di un rettangolo.
ERROR
La finestra specificata non ha un'area o si è verificato un errore durante il tentativo di restituire l'area.

Commenti

Le coordinate dell'area della finestra di una finestra sono relative all'angolo superiore sinistro della finestra, non all'area client della finestra.

Per impostare l'area della finestra di una finestra, chiamare la funzione SetWindowRgn .

Esempio

Il codice seguente illustra come passare l'handle di un'area esistente.


HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR) 
{ 
/* hrgn contains window region */ 
}
DeleteObject(hrgn); /* finished with region */

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-2 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

Funzioni di disegno e disegno

Panoramica di disegno e disegno

SetWindowRgn