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 及更高版本中，窗口矩形现在包括投影所占用的区域。

调用 GetWindowRect 将具有不同的行为，具体取决于窗口是否已显示。 如果以前未显示窗口，则 GetWindowRect 将不包括投影区域。

若要获取窗口边界（不包括投影），请使用 DwmGetWindowAttribute，指定 DWMWA_EXTENDED_FRAME_BOUNDS。 请注意，与窗口矩形不同，DWM 扩展帧边界不会针对 DPI 进行调整。 获取扩展框架边界只能在窗口至少显示一次之后完成。

示例

有关示例，请参阅 初始化对话框。

要求

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

请参阅

概念性

GetClientRect

引用

ScreenToClient

SetWindowPos

Windows