Funzione GetWindowRect (winuser.h)

Articolo
08/27/2023

Recupera le dimensioni del rettangolo di selezione della finestra specificata. Le dimensioni vengono specificate nelle coordinate dello schermo relative all'angolo superiore sinistro dello schermo.

Sintassi

BOOL GetWindowRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect
);

Parametri

[in] hWnd

Tipo: HWND

Handle nella finestra.

[out] lpRect

Tipo: LPRECT

Puntatore a una struttura RECT che riceve le coordinate dello schermo degli angoli superiore sinistro e inferiore destro della finestra.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

In conformità con le convenzioni per la struttura RECT , le coordinate in basso a destra del rettangolo restituito sono esclusive. In altre parole, il pixel in corrispondenza (destra, inferiore) si trova immediatamente all'esterno del rettangolo.

GetWindowRect è virtualizzato per DPI.

In Windows Vista e versioni successive la finestra Rect ora include l'area occupata dall'ombreggiatura a discesa.

La chiamata a GetWindowRect avrà un comportamento diverso a seconda che la finestra sia mai stata visualizzata o meno. Se la finestra non è stata visualizzata prima, GetWindowRect non includerà l'area dell'ombreggiatura a discesa.

Per ottenere i limiti di finestra esclusi l'ombreggiatura a discesa, usare DwmGetWindowAttribute, specificando DWMWA_EXTENDED_FRAME_BOUNDS. Si noti che a differenza di Window Rect, i limiti di frame estesi DWM non vengono regolati per DPI. Ottenere i limiti di frame estesi può essere eseguito solo dopo che la finestra è stata visualizzata almeno una volta.

Esempio

Per un esempio, vedere Inizializzazione di una finestra di dialogo.

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-window-l1-1-0 (introdotto in Windows 8)