WindowTabManager.TabTearOutRequested 事件

定義

命名空間:

Windows.UI.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 和其他應用程式類型。

當 Tab 鍵顯示在 Snap Assist 工具中，且使用者選擇在不同的視窗中貼齊特定索引標籤時，就會發生索引標籤卸載要求。

並非所有版本的 Windows 都支援引發此事件的案例，因此請在訂閱 TabTearOutRequested 事件之前呼叫IsTabTearOutSupported，並且只有在傳回 true 時才訂閱 。

如果您的 app 不支援索引標籤卸載，其索引標籤將不會顯示在 Snap Assist 中。