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 现在可能包含不可见的大小边框。

若要获取可见窗口边界(不包括不可见大小边框)请使用 DwmGetWindowAttribute,指定 DWMWA_EXTENDED_FRAME_BOUNDS。 请注意,与窗口矩形不同,DWM 扩展帧边界不会针对 DPI 进行调整。

例子

有关示例,请参阅 “初始化对话框”。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows操作系统
标头 winuser.h (包括 Windows.h)
图书馆 User32.lib
DLL User32.dll
API 集 ext-ms-win-ntuser-window-l1-1-0(在 Windows 8 中引入)

另请参阅

概念

GetClientRect

参考

ScreenToClient

SetWindowPos

Windows