TabView Класс

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Элемент управления TabView позволяет отобразить набор вкладок и их содержимое. Элементы управления вкладками полезны для отображения нескольких страниц (или документов) содержимого, предоставляя пользователю возможность изменять порядок, открывать или закрывать новые вкладки.

Выбор правильного элемента управления

Используйте TabView, чтобы помочь пользователю управлять несколькими страницами приложений или документами в одном окне.

Не используйте TabView для отображения статического набора вкладок, которые пользователь не может изменить, открыть или закрыть. Вместо этого используйте NavigationView (NavigationViewPaneDisplayMode top).

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class TabView : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class TabView : Control

Public Class TabView
Inherits Control

Наследование

Control

TabView

Атрибуты

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Примеры

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Представление вкладок.

Откройте приложение "Коллекция WinUI 2" и просмотрите вкладку TabView в действии.

Приложения из коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 2. Получите приложение из Microsoft Store или получите исходный код в GitHub.

Базовый пример TabView, похожий на веб-браузер

<TabView AddTabButtonClick="Tabs_AddTabButtonClick"
         TabCloseRequested="Tabs_TabCloseRequested" />

// Add a new Tab to the TabView
private void Tabs_AddTabButtonClick(TabView sender, TabViewAddTabButtonClickEventArgs e)
{
    var newTab = new TabViewItem();
    newTab.IconSource = new SymbolIconSource() { Symbol = Symbol.Document };
    newTab.Header = "New Document";

    // The Content of a TabViewItem is often a frame which hosts a page.
    Frame frame = new Frame();
    newTab.Content = frame;
    frame.Navigate(typeof(BaconIpsumPage));

    sender.TabItems.Add(newTab);
}

// Remove the requested tab from the TabView
private void Tabs_TabCloseRequested(TabView sender, TabViewTabCloseRequestedEventArgs args)
{
    sender.TabItems.Remove(args.Tab);
}

Комментарии

Стиль и шаблон элемента управления

Вы можете изменить стандартные параметры Style и ControlTemplate , чтобы придать элементу управления уникальный внешний вид. Сведения об изменении стиля и шаблона элемента управления см. в статье Стили XAML. Стиль по умолчанию, шаблон и ресурсы, определяющие внешний вид элемента управления, включаются в generic.xaml файл . В целях generic.xaml проектирования устанавливается вместе с пакетом NuGet WinUI (Microsoft.UI.Xaml). По умолчанию, это расположение \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Стили и ресурсы из разных версий WinUI могут иметь разные значения.

XAML также включает ресурсы, которые можно использовать для изменения цветов элемента управления в различных визуальных состояниях без изменения шаблона элемента управления. Изменение этих ресурсов предпочтительнее, чем установка таких свойств, как Background и Foreground. Дополнительные сведения см. в разделе Облегчаемые стили статьио стилях XAML .

Конструкторы

TabView()

Инициализирует новый экземпляр класса TabView . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Свойства

AddTabButtonCommand	Возвращает или задает команду, вызываемую при нажатии кнопки добавления (+). Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
AddTabButtonCommandParameter	Возвращает или задает параметр для передачи в свойство AddTabButtonCommand. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
AddTabButtonCommandParameterProperty	Определяет свойство зависимости AddTabButtonCommandParameter . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
AddTabButtonCommandProperty	Определяет свойство зависимости AddButtonCommand. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
AllowDropTabs	Возвращает или задает значение, определяющее, может ли tabView быть целевым объектом перетаскивания для операций перетаскивания. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
AllowDropTabsProperty	Определяет свойство зависимостей AllowDropTabs . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
CanDragTabs	Возвращает или задает значение, указывающее, можно ли перетаскивать вкладки в качестве полезных данных. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
CanDragTabsProperty	Определяет свойство зависимостей CanDragTabs . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
CanReorderTabs	Возвращает или задает значение, указывающее, можно ли изменить порядок вкладок в TabStrip с помощью взаимодействия с пользователем. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
CanReorderTabsProperty	Определяет свойство зависимости CanReorderTabs . Определяет свойство зависимости CanReorderTabs. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
CloseButtonOverlayMode	Возвращает или задает значение, указывающее поведение кнопки закрытия на вкладках. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
CloseButtonOverlayModeProperty	Определяет свойство зависимости CloseButtonOverlayMode . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
IsAddTabButtonVisible	Возвращает или задает значение, указывающее, отображается ли кнопка добавления вкладки (+). Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
IsAddTabButtonVisibleProperty	Определяет свойство зависимости IsAddTabButtonVisible . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
SelectedIndex	Возвращает или задает индекс выбранного элемента. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
SelectedIndexProperty	Определяет свойство зависимости SelectedIndex . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
SelectedItem	Возвращает или задает выбранный элемент. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
SelectedItemProperty	Определяет свойство зависимости SelectedItem . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItems	Возвращает коллекцию, используемую для создания вкладок в элементе управления . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItemsProperty	Определяет свойство зависимостей TabItems . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItemsSource	Возвращает или задает источник объекта, используемый для создания вкладок в TabView. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItemsSourceProperty	Определяет свойство зависимости TabItemsSource . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItemTemplate	Возвращает или задает объект DataTemplate, используемый для отображения каждого элемента. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItemTemplateProperty	Определяет свойство зависимости TabItemTemplate . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItemTemplateSelector	Возвращает или задает объект выбора, который изменяет DataTemplate для применения к содержимому на основе данных об обработке сведений об элементе содержимого или его контейнере во время выполнения. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItemTemplateSelectorProperty	Определяет свойство зависимости TabItemTemplateSelector . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripFooter	Возвращает или задает содержимое, отображаемое справа от полосы вкладок. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripFooterProperty	Определяет свойство зависимости TabStripFooter . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripFooterTemplate	Возвращает или задает объект DataTemplate, используемый для отображения содержимого объекта TabStripFooter. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripFooterTemplateProperty	Определяет свойство зависимости TabStripFooterTemplate . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripHeader	Возвращает или задает содержимое, отображаемое слева от полосы табуляции. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripHeaderProperty	Определяет свойство зависимости TabStripHeader . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripHeaderTemplate	Возвращает или задает объект DataTemplate, используемый для отображения содержимого TabStripHeader. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripHeaderTemplateProperty	Определяет свойство зависимости TabStripHeaderTemplate . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabWidthMode	Возвращает или задает размер вкладок. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabWidthModeProperty	Определяет свойство зависимости TabWidthMode. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Методы

ContainerFromIndex(Int32)	Возвращает контейнер для элемента по указанному индексу в коллекции. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
ContainerFromItem(Object)	Возвращает контейнер, соответствующий указанному элементу. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

События

AddTabButtonClick	Происходит при нажатии кнопки добавления вкладки (+). Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
SelectionChanged	Происходит при изменении выбранной вкладки. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabCloseRequested	Возникает, когда пользователь пытается закрыть вкладку с помощью нажатия кнопки "от X до закрытия", CTRL+F4 или мыши. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabDragCompleted	Возникает, когда пользователь завершает действие перетаскивания. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabDragStarting	Происходит при инициации операции перетаскивания. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabDroppedOutside	Происходит, когда пользователь завершает операцию перетаскивания путем перетаскивания вкладки за пределы области TabStrip. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabItemsChanged	Возникает при изменении коллекции элементов. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripDragOver	Происходит, когда система ввода сообщает о базовом событии перетаскивания с tabStrip в качестве потенциального целевого объекта перетаскивания. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
TabStripDrop	Происходит, когда система ввода сообщает о базовом событии удаления с tabStrip в качестве целевого объекта удаления. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

См. также раздел

• TabViewItem
• TabViewCloseButtonOverlayMode
• Рекомендации по TabView