Skip to content

Latest commit

 

History

History
36 lines (24 loc) · 1.22 KB

windowtabmanager_tabtearoutrequested.md

File metadata and controls

36 lines (24 loc) · 1.22 KB
Raw
-api-id -api-type
E:Windows.UI.Shell.WindowTabManager.TabTearOutRequested
winrt event

Windows.UI.Shell.WindowTabManager.TabTearOutRequested

-description

Occurs when the system shell requests a separate window for a specific tab.

-remarks

Important

This API is for Win32 desktop apps only. UWP and other app types are not supported.

A tab tear out request can happen when tabs show in the Snap Assist tool and the user chooses to have a specific tab snapped in a different window.

Not all versions of Windows support the scenarios that raise this event, so call IsTabTearOutSupported before subscribing to the TabTearOutRequested event and subscribe only if it returns true.

If your app does not support tab tear out, its tabs will not show in Snap Assist.

-see-also

-examples

if (WindowTabManager::IsTabTearOutSupported())
{
    m_tabTearOutRequestedRevoker = m_tabManager.TabTearOutRequested(winrt::auto_revoke, { this, &MainWindow::TabTearOutRequested });
}