Funzione GetWindowRect (winuser.h)
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) |
Vedi anche
Informazioni concettuali
Riferimento