TabView Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

O controle TabView é uma maneira de exibir um conjunto de guias e seu respectivo conteúdo. Os controles tab são úteis para exibir várias páginas (ou documentos) de conteúdo, dando ao usuário a capacidade de reorganizar, abrir ou fechar novas guias.

Esse é o controle correto?

Use um TabView para ajudar o usuário a gerenciar várias páginas de aplicativos ou documentos na mesma janela.

Não use um TabView para exibir um conjunto estático de guias que o usuário não pode reorganizar, abrir ou fechar. Use um NavigationView (NavigationViewPaneDisplayMode of Top) em vez disso.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

/// [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

Herança

Control

TabView

Atributos

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Exibição de tabulação.

Abra o aplicativo Galeria do WinUI 2 e consulte TabView em ação.

Os aplicativos da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 2. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub.

Exemplo de TabView básico, semelhante a um navegador da Web

<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);
}

Comentários

Estilo e modelo de controle

Você pode modificar o Estilo e ControlTemplate padrão para dar ao controle uma aparência exclusiva. Para obter informações sobre como modificar o estilo e o modelo de um controle, consulte Estilos XAML. O estilo, o modelo e os recursos padrão que definem a aparência do controle são incluídos no generic.xaml arquivo. Para fins de design, generic.xaml é instalado com o pacote NuGet WinUI (Microsoft.UI.Xaml). Por padrão, esse local é \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Estilos e recursos de diferentes versões do WinUI podem ter valores diferentes.

O XAML também inclui recursos que você pode usar para modificar as cores de um controle em diferentes estados visuais sem modificar o modelo de controle. É preferível modificar esses recursos para definir propriedades como Plano de Fundo e Primeiro Plano. Para obter mais informações, consulte a seção Estilo leve do artigo Estilos XAML .

Construtores

TabView()

Inicializa uma nova instância da classe TabView . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades

AddTabButtonCommand	Obtém ou define o comando a ser invocado quando o botão adicionar (+) é tocado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
AddTabButtonCommandParameter	Obtém ou define o parâmetro a ser passado para a propriedade AddTabButtonCommand. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
AddTabButtonCommandParameterProperty	Identifica a propriedade de dependência AddTabButtonCommandParameter . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
AddTabButtonCommandProperty	Identifica a propriedade de dependência AddButtonCommand. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
AllowDropTabs	Obtém ou define um valor que determina se o TabView pode ser um destino de soltar para fins de operações de arrastar e soltar. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
AllowDropTabsProperty	Identifica a propriedade de dependência AllowDropTabs . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CanDragTabs	Obtém ou define um valor que indica se as guias podem ser arrastadas como uma carga de dados. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CanDragTabsProperty	Identifica a propriedade de dependência CanDragTabs . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CanReorderTabs	Obtém ou define um valor que indica se as guias no TabStrip podem ser reordenadas por meio da interação do usuário. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CanReorderTabsProperty	Identifica a propriedade de dependência CanReorderTabs . Identifica a propriedade de dependência CanReorderTabs. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonOverlayMode	Obtém ou define um valor que indica o comportamento do botão fechar dentro de guias. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CloseButtonOverlayModeProperty	Identifica a propriedade de dependência CloseButtonOverlayMode . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsAddTabButtonVisible	Obtém ou define se o botão adicionar (+) guia está visível. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsAddTabButtonVisibleProperty	Identifica a propriedade de dependência IsAddTabButtonVisible . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectedIndex	Obtém ou define o índice do item selecionado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectedIndexProperty	Identifica a propriedade de dependência SelectedIndex . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectedItem	Obtém ou define o item selecionado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectedItemProperty	Identifica a propriedade de dependência SelectedItem . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItems	Obtém a coleção usada para gerar as guias dentro do controle . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItemsProperty	Identifica a propriedade de dependência TabItems . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItemsSource	Obtém ou define uma fonte de objeto usada para gerar as guias no TabView. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItemsSourceProperty	Identifica a propriedade de dependência TabItemsSource . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItemTemplate	Obtém ou define o DataTemplate usado para exibir cada item. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItemTemplateProperty	Identifica a propriedade de dependência TabItemTemplate . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItemTemplateSelector	Obtém ou define um objeto de seleção que altera o DataTemplate para aplicar ao conteúdo, com base no processamento de informações sobre o item de conteúdo ou seu contêiner em tempo de execução. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItemTemplateSelectorProperty	Identifica a propriedade de dependência TabItemTemplateSelector . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripFooter	Obtém ou define o conteúdo que é mostrado à direita da faixa de guias. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripFooterProperty	Identifica a propriedade de dependência TabStripFooter . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripFooterTemplate	Obtém ou define o DataTemplate usado para exibir o conteúdo do TabStripFooter. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripFooterTemplateProperty	Identifica a propriedade de dependência TabStripFooterTemplate . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripHeader	Obtém ou define o conteúdo mostrado à esquerda da faixa de tabulação. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripHeaderProperty	Identifica a propriedade de dependência TabStripHeader . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripHeaderTemplate	Obtém ou define o DataTemplate usado para exibir o conteúdo do TabStripHeader. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripHeaderTemplateProperty	Identifica a propriedade de dependência TabStripHeaderTemplate . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabWidthMode	Obtém ou define como as guias devem ser dimensionadas. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabWidthModeProperty	Identifica a propriedade de dependência TabWidthMode. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Métodos

ContainerFromIndex(Int32)	Retorna o contêiner do item no índice especificado dentro da coleção. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ContainerFromItem(Object)	Retorna o contêiner correspondente ao item especificado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Eventos

AddTabButtonClick	Ocorre quando o botão adicionar guia (+) foi clicado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectionChanged	Ocorre quando a guia selecionada no momento é alterada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabCloseRequested	Gerado quando o usuário tenta fechar uma Guia clicando no botão x-to-close, CTRL+F4 ou mousewheel. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabDragCompleted	Gerado quando o usuário conclui a ação de arrastar. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabDragStarting	Ocorre quando uma operação de arrastar é iniciada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabDroppedOutside	Ocorre quando o usuário conclui uma operação de arrastar e soltar soltando uma guia fora da área tabStrip. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabItemsChanged	Gerado quando a coleção de itens é alterada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripDragOver	Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com o TabStrip como o destino de soltar potencial. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TabStripDrop	Ocorre quando o sistema de entrada relata um evento de soltar subjacente com o TabStrip como o destino de soltar. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Confira também

• TabViewItem
• TabViewCloseButtonOverlayMode
• Diretrizes para TabView