TabView.TabDroppedOutside イベント

定義

名前空間:

Microsoft.UI.Xaml.Controls

TabStrip 領域の外側にタブをドロップして、ユーザーがドラッグ アンド ドロップ操作を完了したときに発生します。

// 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;

function onTabDroppedOutside(eventArgs) { /* Your code */ }
tabView.addEventListener("tabdroppedoutside", onTabDroppedOutside);
tabView.removeEventListener("tabdroppedoutside", onTabDroppedOutside);
- or -
tabView.ontabdroppedoutside = onTabDroppedOutside;

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

イベントの種類

TypedEventHandler<TabView,TabViewTabDroppedOutsideEventArgs>

例

ヒント

詳細、設計ガイダンス、およびコード例については、「 TabView」を参照してください。

WinUI 3 ギャラリー アプリを開き、TabView の動作を確認します。

WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

<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();
}

注釈

このイベントを使用して、新しいウィンドウを作成できます。

コンテンツをアプリ内でホストする方法はさまざまです。 「1 つのアプリの複数のビューを表示する」ドキュメントでは、複数のビューまたはウィンドウを表示するためのさまざまなテクノロジについて説明しています。

次の例では AppWindow を使用します。これは、Windows 10 バージョン 1903 (SDK 18362) 以降で使用できます。 AppWindow は、作成元と同じ UI スレッドで動作するため、マルチウィンドウ UWP アプリの作成を簡略化します。

アプリが 1903 未満Windows 10バージョンを対象とする場合は、CoreWindow/ApplicationView を使用する必要があります。 Windows Community Toolkit TabView のティアアウト サンプル は、CoreWindow/ApplicationView を使用してマルチウィンドウ アプリケーションを作成する方法を示しています。