ITaskbarList2：：MarkFullscreenWindow 方法 (shobjidl_core.h)

  • 项目

将窗口标记为全屏。

语法

HRESULT MarkFullscreenWindow(
  [in] HWND hwnd,
  [in] BOOL fFullscreen
);

参数

[in] hwnd

类型：HWND

要标记的窗口的句柄。

[in] fFullscreen

类型： BOOL

一个布尔值，用于标记窗口的所需全屏状态。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

将 fFullscreen 的值设置为 TRUE，Shell 会将此窗口视为全屏窗口，当此窗口处于活动状态时，任务栏将移动到 z 顺序的底部。 将 fFullscreen 的值设置为 FALSE 会删除全屏标记 ，但不会导致 Shell 将窗口视为肯定不是全屏窗口。 使用 FALSEfFullscreen 值时，Shell 依赖于其自动检测工具来指定窗口的处理方式，可能仍然将窗口标记为全屏。

由于 Windows 7， 请在显示窗口之前调用 SetProp(hwnd, L”NonRudeHWND”, reinterpret_cast<HANDLE>(TRUE)) ，以向 Shell 指示不应将窗口视为全屏窗口。 这可确保任务栏不会将自身调整为 z 顺序的窗口下方。 这类似于 ITaskbarList2::MarkFullscreenWindow(FALSE) ，但 Shell 不会回退到其自动检测工具，也不会将窗口视为全屏窗口。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll

另请参阅

ITaskbarList

ITaskbarList2

SetPropA

SetPropW