TabView.TabDroppedOutside 事件

定義

命名空間:

Microsoft.UI.Xaml.Controls

當使用者在 TabStrip 區域外卸載索引標籤來完成拖放作業時發生。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

// Register
event_token TabDroppedOutside(TypedEventHandler<TabView, TabViewTabDroppedOutsideEventArgs const&> const& handler) const;

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

// Revoke with event_revoker
TabView::TabDroppedOutside_revoker TabDroppedOutside(auto_revoke_t, TypedEventHandler<TabView, TabViewTabDroppedOutsideEventArgs const&> const& handler) const;

public event TypedEventHandler<TabView,TabViewTabDroppedOutsideEventArgs> TabDroppedOutside;

Public Custom Event TabDroppedOutside As TypedEventHandler(Of TabView, TabViewTabDroppedOutsideEventArgs) 

事件類型

TypedEventHandler<TabView,TabViewTabDroppedOutsideEventArgs>

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 TabView。

WinUI 3 資源庫和WinUI 2 資源庫應用程式包含大部分 WinUI 3 和 WinUI 2 控制項、功能和功能的互動式範例。

如果已安裝，請按一下下列連結加以開啟： WinUI 3 資源庫 或 WinUI 2 資源庫。

如果未安裝，您可以從 Microsoft Store 下載 WinUI 3 資源庫 和 WinUI 2 資源庫 。

您也可以從 GitHub 取得的原始程式碼 (使用 WinUI 3 的主要 分支，以及 WinUI 2) 的 winui2 分支。

<TabView TabDroppedOutside="TabView_TabDroppedOutside">

// NOTE: The app is responsible for writing this code. A full sample can be found in the Xaml Controls Gallery.
private async void TabView_TabDroppedOutside(TabView sender, TabDroppedOutsideEventArgs e)
{
    // Create a new AppWindow
    AppWindow newWindow = await AppWindow.TryCreateAsync();

    // Create the content for the new window
    var newPage = new MainPage();

    // Remove tab from existing list
    Tabs.TabItems.Remove(e.Tab);

    // Add tab to list of Tabs on new page
    newPage.AddItemToTabs(e.Tab);

    // Set the Window's content to the new page
    ElementCompositionPreview.SetAppWindowContent(newWindow, newPage);

    // Show the window
    await newWindow.TryShowAsync();
}

備註

您可以使用此事件來建立新的視窗。

有許多不同的方式可以在應用程式內裝載內容。 應用程式檔的 [顯示多個檢視] 概述顯示多個檢視或視窗的各種技術。

下列範例使用 AppWindow，從 Windows 10 1903 版 (SDK 18362) 開始提供。 AppWindow 可簡化多視窗 UWP 應用程式的建立，因為它在建立來源的相同 UI 執行緒上運作。

如果您的應用程式以低於 1903 Windows 10 版本為目標，您必須使用 CoreWindow/ApplicationView。 Windows Community Toolkit TabView 卸載範例 示範如何使用 CoreWindow/ApplicationView 建立多視窗應用程式。