WindowTabManager.TabTearOutRequested 事件

  • 参考

定义

命名空间:
Windows.UI.Shell
编辑

当系统 shell 请求特定选项卡的单独窗口时发生。

// Register
event_token TabTearOutRequested(TypedEventHandler<WindowTabManager, WindowTabTearOutRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void TabTearOutRequested(event_token const* cookie) const;

// Revoke with event_revoker
WindowTabManager::TabTearOutRequested_revoker TabTearOutRequested(auto_revoke_t, TypedEventHandler<WindowTabManager, WindowTabTearOutRequestedEventArgs const&> const& handler) const;
public event TypedEventHandler<WindowTabManager,WindowTabTearOutRequestedEventArgs> TabTearOutRequested;
function onTabTearOutRequested(eventArgs) { /* Your code */ }
windowTabManager.addEventListener("tabtearoutrequested", onTabTearOutRequested);
windowTabManager.removeEventListener("tabtearoutrequested", onTabTearOutRequested);
- or -
windowTabManager.ontabtearoutrequested = onTabTearOutRequested;
Public Custom Event TabTearOutRequested As TypedEventHandler(Of WindowTabManager, WindowTabTearOutRequestedEventArgs)

事件类型

TypedEventHandler<WindowTabManager,WindowTabTearOutRequestedEventArgs>

示例

if (WindowTabManager::IsTabTearOutSupported())
{
    m_tabTearOutRequestedRevoker = m_tabManager.TabTearOutRequested(winrt::auto_revoke, { this, &MainWindow::TabTearOutRequested });
}

注解

重要

此 API 仅适用于 Win32 桌面应用。 不支持 UWP 和其他应用类型。

当选项卡显示在贴靠助手工具中，并且用户选择将特定选项卡贴靠在不同的窗口中时，可能会发生选项卡撕裂请求。

并非所有版本的 Windows 都支持引发此事件的方案，因此在订阅TabTearOutRequested事件之前调用 IsTabTearOutSupported，并且仅在它返回 true时订阅。

如果应用不支持选项卡撕裂，其选项卡将不会显示在贴靠助手中。

适用于