检索指定窗口的边界矩形的尺寸。 尺寸以相对于屏幕左上角的屏幕坐标提供。
语法
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 中引入) |
另请参阅
概念
参考