Funzione GetWindowRect (winuser.h)

Recupera le dimensioni del rettangolo di delimitazione 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 per la 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni:

In conformità alle 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 viene virtualizzato per DPI.

In Windows Vista e versioni successive, La correzione finestra può ora includere bordi di ridimensionamento invisibili.

Per ottenere i limiti di finestra visibili, non inclusi i bordi di ridimensionamento invisibili, usare DwmGetWindowAttribute, specificando DWMWA_EXTENDED_FRAME_BOUNDS. Si noti che, a differenza di Window Rect, i limiti dei frame estesi DWM non vengono regolati per DPI.

Esempi

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

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)
Biblioteca	User32.lib
DLL	User32.dll
set di API	ext-ms-win-ntuser-window-l1-1-0 (introdotto in Windows 8)

Vedere anche

Concettuale

GetClientRect

Riferimento

ScreenToClient

SetWindowPos

Windows