Share via

getWindowPlacement 函数 (winuser.h)

  • 项目

检索指定窗口的显示状态以及还原、最小化和最大化的位置。

语法

BOOL GetWindowPlacement(
  [in]      HWND            hWnd,
  [in, out] WINDOWPLACEMENT *lpwndpl
);

参数

[in] hWnd

类型：HWND

窗口的句柄。

[in, out] lpwndpl

类型： WINDOWPLACEMENT*

指向接收显示状态和位置信息的 WINDOWPLACEMENT 结构的指针。 在调用 GetWindowPlacement 之前，请将 length 成员设置为 sizeof(WINDOWPLACEMENT)。 如果未正确设置 lpwndpl-length，GetWindowPlacement > 将失败。

返回值

类型： BOOL

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

此函数检索的 WINDOWPLACEMENT 的标志成员始终为零。 如果 hWnd 参数标识的窗口最大化，则 showCmd 成员SW_SHOWMAXIMIZED。 如果窗口最小化， 则SW_SHOWMINIMIZED showCmd 。 否则，它将SW_SHOWNORMAL。

WINDOWPLACEMENT 的 length 成员必须设置为 sizeof (WINDOWPLACEMENT) 。 如果未正确设置此成员，则函数返回 FALSE。 有关正确使用窗口放置坐标的其他说明，请参阅 WINDOWPLACEMENT。

要求

要求 值
最低受支持的客户端 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 (

请参阅

概念性

引用

SetWindowPlacement

WINDOWPLACEMENT

Windows