Funzione GetWindowRgnBox (winuser.h)

Articolo
03/13/2024

La funzione GetWindowRgnBox recupera le dimensioni del rettangolo di limite più stretto per l'area della finestra di una finestra.

Sintassi

int GetWindowRgnBox(
  [in]  HWND   hWnd,
  [out] LPRECT lprc
);

Parametri

[in] hWnd

Handle nella finestra.

[out] lprc

Puntatore a una struttura RECT che riceve le dimensioni del rettangolo, nelle unità di dispositivo rispetto all'angolo superiore sinistro della finestra.

Valore restituito

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

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

Commenti

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

Requisiti

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