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 |