擷取指定視窗周框的維度。 維度會以相對於螢幕左上角的螢幕座標來指定。
語法
BOOL GetWindowRect(
[in] HWND hWnd,
[out] LPRECT lpRect
);
參數
[in] hWnd
類型:HWND
視窗的句柄。
[out] lpRect
類型:LPRECT
RECT 結構的指標,可接收視窗左上角和右下角的螢幕座標。
返回值
類型:BOOL
如果函式成功,則傳回值為非零值。
如果函式失敗,傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
與 RECT 結構的慣例一致,傳回矩形的右下角座標是獨佔的。 換句話說,位於(右、 下)的圖元緊接在矩形外。
GetWindowRect 已虛擬化為 DPI。
在 Windows Vista 和更新版本中,Window Rect 現在可能包含不可見的重設大小框線。
若要取得可見視窗界限,不包括不可見的重設大小框線,請使用 DwmGetWindowAttribute,並指定 DWMWA_EXTENDED_FRAME_BOUNDS。 請注意,不同於 Window Rect,DWM 擴充框架界限不會針對 DPI 進行調整。
範例
如需範例,請參閱 初始化對話方塊。
需求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標題 | winuser.h (包括 Windows.h) |
程式庫 | User32.lib |
DLL | User32.dll |
API 集 | ext-ms-win-ntuser-window-l1-1-0 (在 Windows 8 中引進) |
另請參閱
概念性的
參考