SetWindowPlacement 函数 (winuser.h)

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

语法

BOOL SetWindowPlacement(
  [in] HWND                  hWnd,
  [in] const WINDOWPLACEMENT *lpwndpl
);

参数

[in] hWnd

类型:HWND

窗口的句柄。

[in] lpwndpl

类型: const WINDOWPLACEMENT*

指向 WINDOWPLACEMENT 结构的指针,该结构指定新的显示状态和窗口位置。

在调用 SetWindowPlacement 之前,请将 WINDOWPLACEMENT 结构的长度成员设置为 sizeof (WINDOWPLACEMENT) 。 如果未正确设置长度成员,SetWindowPlacement 将失败。

返回值

类型: BOOL

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

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

注解

如果 WINDOWPLACEMENT 中指定的信息会导致窗口完全离开屏幕,系统会根据屏幕分辨率和多个监视器配置的变化,自动调整坐标,使窗口可见。

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

要求

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

请参阅

概念性

GetWindowPlacement

引用

WINDOWPLACEMENT

Windows