GetWindowRect 函式 (winuser.h)

擷取指定視窗周框的維度。維度會以相對於螢幕左上角的螢幕座標來提供。

語法

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

[in] hWnd

類型： HWND

視窗的控制碼。

[out] lpRect

類型： LPRECT

RECT結構的指標，可接收視窗左上角和右下角的螢幕座標。

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

與 RECT 結構的慣例一致，傳回矩形的右下角座標是獨佔的。換句話說，位於右下方 (圖元) 緊 接在矩形外。

GetWindowRect 已針對 DPI 虛擬化。

在 Windows Vista 和更新版本中，Window Rect 現在包含陰影所佔用的區域。

呼叫 GetWindowRect 會根據視窗是否顯示而有不同的行為。如果之前尚未顯示視窗，GetWindowRect 將不會包含陰影的區域。

若要取得排除陰影的視窗界限，請使用 DwmGetWindowAttribute，並指定 DWMWA_EXTENDED_FRAME_BOUNDS。請注意，不同于 Window Rect，DWM 擴充框架界限不會針對 DPI 進行調整。只有在視窗至少顯示一次之後，才能取得延伸框架界限。

如需範例，請參閱初始化對話方塊。


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-window-l1-1-0 (在 Windows 8)