TabView.TabDroppedOutside イベント

定義

名前空間:

Microsoft.UI.Xaml.Controls

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

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、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 の場合は main ブランチ、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();
}

注釈

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

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

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

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