TreeView Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

É uma lista hierárquica com nós em expansão e em colapso que contêm itens aninhados.

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)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class TreeView : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class TreeView : Control

Public Class TreeView
Inherits Control

Herança

Control

TreeView

Atributos

MarshalingBehaviorAttribute ThreadingAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute

Exemplos

Dica

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

Abra o aplicativo Galeria do WinUI 2 e consulte TreeView 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.

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

TreeView()

Inicializa uma nova instância do controle TreeView. 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

CanDragItems	Obtém ou define um valor que indica se os itens na exibição podem ser arrastados como conteúdo 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).
CanDragItemsProperty	Identifica a propriedade de dependência CanDragItems. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
CanReorderItems	Obtém ou define um valor que indica se os itens na exibição podem ser reordenados 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).
CanReorderItemsProperty	Identifica a propriedade de dependência CanReorderItems. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemContainerStyle	Obtém ou define o estilo usado ao renderizar os contêineres de 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).
ItemContainerStyleProperty	Identifica a propriedade de dependência ItemContainerStyle. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemContainerStyleSelector	Obtém ou define uma referência a uma classe lógica StyleSelector personalizada. O StyleSelector retorna valores de Estilo diferentes a serem usados para o contêiner de item com base nas características do objeto que está sendo exibido. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemContainerStyleSelectorProperty	Identifica a propriedade de dependência ItemContainerStyleSelector. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemContainerTransitions	Obtém ou define a coleção de elementos de estilo de transição que se aplicam aos contêineres de item de um TreeView. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemContainerTransitionsProperty	Identifica a propriedade de dependência ItemContainerTransitions. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemsSource	Obtém ou define uma fonte de objeto usada para gerar o conteúdo do TreeView. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemsSourceProperty	Identifica a propriedade de dependência ItemsSource. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemTemplate	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).
ItemTemplateProperty	Identifica a propriedade de dependência ItemTemplate. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemTemplateSelector	Obtém ou define uma referência a uma classe lógica DataTemplateSelector personalizada. O DataTemplateSelector referenciado por essa propriedade retorna um modelo a ser aplicado aos itens. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemTemplateSelectorProperty	Identifica a propriedade de dependência ItemTemplateSelector. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
RootNodes	Obtém ou define a coleção de nós raiz da árvore. 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 a propriedade SelectedItem de um TreeView. 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).
SelectedItems	Obtém os itens selecionados no momento. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectedNode	Obtém ou define o nó selecionado na árvore. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectedNodes	Obtém ou define a coleção de nós selecionados na árvore. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectionMode	Obtém ou define o comportamento de seleção de uma instância treeview . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectionModeProperty	Identifica a propriedade de dependência SelectionMode. 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

Collapse(TreeViewNode)	Recolhe o nó especificado na árvore. 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).
ContainerFromNode(TreeViewNode)	Retorna o contêiner correspondente ao nó 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).
Expand(TreeViewNode)	Expande o nó especificado na árvore. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemFromContainer(DependencyObject)	Retorna o item que corresponde ao contêiner especificado e gerado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
NodeFromContainer(DependencyObject)	Retorna o TreeViewNode correspondente ao contêiner 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).
SelectAll()	Seleciona todos os nós na árvore. 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

Collapsed	Ocorre quando um nó na árvore é recolhido. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
DragItemsCompleted	Ocorre quando uma operação de arrastar que envolve um dos itens na exibição é encerrada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
DragItemsStarting	Ocorre quando uma operação de arrastar que envolve um dos itens na exibição é 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).
Expanding	Ocorre quando um nó na árvore começa a ser expandido. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ItemInvoked	Ocorre quando um item na árvore é invocado. 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

• TreeViewCollapsedEventArgs
• TreeViewDragItemsCompletedEventArgs
• TreeViewDragItemsStartingEventArgs
• TreeViewExpandingEventArgs
• TreeViewItem
• TreeViewItemInvokedEventArgs
• TreeViewItemTemplateSettings
• TreeViewList
• TreeViewNode
• TreeViewSelectionMode
• Visão geral de TreeView