Поделиться через


TabView Класс

Определение

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

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

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

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

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class TabView : Control
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class TabView : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class TabView : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
public 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
Наследование
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 пространства имен).

Применяется к

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