TabView.TabDroppedOutside イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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)
イベントの種類
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 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 を使用してマルチウィンドウ アプリケーションを作成する方法を示しています。