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 |
---|---|
|
L'area è vuota. |
|
L'area è un singolo rettangolo. |
|
L'area è più di un rettangolo. |
|
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) |