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