TabView.TabDroppedOutside Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when the user completes a drag and drop operation by dropping a tab outside of the TabStrip area.
This documentation applies to WinUI 2 for UWP (for WinUI in the Windows App SDK, see the Windows App SDK namespaces).
// 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) Event Type
Examples
Tip
For more info, design guidance, and code examples, see Tab view.
The WinUI 2 Gallery app includes interactive examples of most WinUI 2 controls, features, and functionality.
If installed already, open it by clicking WinUI 2 Gallery.
If they are not installed, you can download the WinUI 2 Gallery from the Microsoft Store.
You can also get the source code from GitHub (use the winui2 branch for WinUI 2).
This example shows how to create a new window for a tab that is dragged out of the tab strip.
<TabView TabDroppedOutside="TabView_TabDroppedOutside">
// NOTE: You need to write this code in your app. A full sample can be found in the WinUI 2 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();
}
Remarks
You can use this event to create a new window.
There are different ways that content can be hosted inside an app. The Show multiple views for an app documentation outlines the various technologies for displaying multiple views or windows.
The example below uses AppWindow, which is available starting in Windows 10, version 1903 (SDK 18362). AppWindow simplifies the creation of multi-window UWP apps because it operates on the same UI thread that it's created from.
If your app targets Windows 10 versions less than 1903, you will need to use CoreWindow/ApplicationView. The Windows Community Toolkit TabView tear out sample demonstrates how to create a multi-window application using CoreWindow/ApplicationView.