TabView.TabDroppedOutside 事件

定义

命名空间:

Microsoft.UI.Xaml.Controls

当用户通过在 TabStrip 区域外放置选项卡完成拖放操作时发生。

本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for 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();
}

注解

可以使用此事件创建新窗口。

可通过不同的方式在应用中托管内容。 显示应用的多个视图文档概述了用于显示多个视图或窗口的各种技术。

以下示例使用 AppWindow，该 AppWindow 从 Windows 10 版本 1903 开始提供， (SDK 18362) 。 AppWindow 简化了多窗口 UWP 应用的创建，因为它在创建它的同一 UI 线程上运行。

如果应用面向Windows 10版本低于 1903，则需要使用 CoreWindow/ApplicationView。 Windows Community Toolkit TabView 拆解示例 演示如何使用 CoreWindow/ApplicationView 创建多窗口应用程序。