Escolar Documentos
Profissional Documentos
Cultura Documentos
Neste artigo
Definição
Exemplos
Observações
Construtores
Propriedades
Métodos
Eventos
Implementações de Interface Explícita
Aplica-se a
Veja também
Definição
Namespace: Sistema. Janelas. Formulários
Conjunto: System.Windows.Forms.dll
C#
[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class TreeView : System.Windows.Forms.Control
Exemplos
O exemplo de código a seguir demonstra o uso do controle TreeView .
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 1/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
C#
C#
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 2/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
// Suppress repainting the TreeView until all the objects have been
created.
treeView1.BeginUpdate();
// Add a child treenode for each Order object in the current Customer
object.
foreach(Order order1 in customer2.CustomerOrders)
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 3/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
{
treeView1.Nodes[customerArray.IndexOf(customer2)].Nodes.Add(
new TreeNode(customer2.CustomerName + "." + order1.OrderID));
}
}
Observações
A coleção Nodes contém todos os objetos TreeNode atribuídos ao controle TreeView .
Os nós da árvore nesta coleção são chamados de nós da árvore raiz. Qualquer nó de
árvore subsequentemente adicionado a um nó de árvore raiz é chamado de nó filho.
Como cada TreeNode pode conter uma coleção de outros objetos TreeNode , você
pode achar difícil determinar sua localização na estrutura da árvore ao iterar na coleção.
Você pode analisar a string TreeNode.FullPath usando o valor de string PathSeparator
para determinar onde um rótulo TreeNode começa e termina.
Você pode exibir imagens próximas aos nós da árvore atribuindo um ImageList à
propriedade ImageList e fazendo referência ao valor de índice de um Image no
ImageList para atribuir esse Image . Use as seguintes propriedades para atribuir
imagens:
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 4/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
XML
<appSettings>
<add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />
</appSettings>
Os nós da árvore podem ser expandidos para exibir o próximo nível de nós da árvore
filho. O usuário pode expandir o TreeNode clicando no botão de sinal de mais (+), se
um for exibido próximo ao TreeNode , ou você pode expandir o TreeNode chamando o
método TreeNode.Expand . Para expandir todos os níveis de nós da árvore filho na
coleção Nodes , chame o método ExpandAll . Você pode recolher o nível de TreeNode
filho chamando o método TreeNode.Collapse ou o usuário pode pressionar o botão de
sinal de menos (-), se um for exibido ao lado de TreeNode . Você também pode chamar
o TreeNode.Togglepara alternar entre os estados expandido e recolhido.
Os nós da árvore podem opcionalmente exibir caixas de seleção. Para exibir as caixas de
seleção, defina a propriedade CheckBoxes do TreeView como true . A propriedade
Checked é configurada true para nós de árvore que estão em um estado marcado.
7 Observação
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 5/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
7 Observação
Construtores
Visualização em Árvore () Inicializa uma nova instância da classe TreeView .
Propriedades
Objeto de Acessibilidade Obtém o AccessibleObject atribuído ao controle.
(Herdado de Control )
Descrição da ação padrão Obtém ou define a descrição de ação padrão do controle para
acessível uso por aplicativos cliente de acessibilidade.
(Herdado de Control )
Permitir soltar Obtém ou define um valor que indica se o controle pode aceitar
dados que o usuário arrasta para ele.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 6/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Pode Ativar Ime Obtém um valor que indica se a propriedade ImeMode pode ser
definida como um valor ativo para habilitar o suporte a IME.
(Herdado de Control )
pode se concentrar Obtém um valor que indica se o controle pode receber o foco.
(Herdado de Control )
Pode selecionar Obtém um valor que indica se o controle pode ser selecionado.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 7/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Validação de causas Obtém ou define um valor que indica se o controle faz com que
a validação seja executada em qualquer controle que exija
validação ao receber o foco.
(Herdado de Control )
Caixas de seleção Obtém ou define um valor que indica se as caixas de seleção são
exibidas próximas aos nós da árvore no controle de exibição de
árvore.
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 8/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Modo Ime padrão Obtém o modo Input Method Editor (IME) padrão com suporte
no controle.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 9/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Seleção de linha completa Obtém ou define um valor que indica se o realce da seleção
abrange a largura do controle de exibição em árvore.
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 10/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
controle.
(Herdado de Control )
É o modo InDesign do site Indica se um dos ancestrais desse controle está localizado e esse
ancestral site está em DesignMode. Esta propriedade é somente leitura.
(Herdado de Control )
Editar etiqueta Obtém ou define um valor que indica se o texto do rótulo dos
nós da árvore pode ser editado.
Cor da linha Obtém ou define a cor das linhas que conectam os nós do
controle TreeView .
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 11/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
contêiner.
(Herdado de Control )
Recriando identificador Obtém um valor que indica se o controle está recriando seu
identificador no momento.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 12/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
(Herdado de Control )
Layout da Direita Para a Obtém ou define um valor que indica se o TreeView deve ser
Esquerda disposto da direita para a esquerda.
Mostrar dicas de foco Obtém um valor que indica se o controle deve exibir retângulos
de foco.
(Herdado de Control )
Mostrar dicas do teclado Obtém um valor que indica se a interface do usuário está no
estado apropriado para mostrar ou ocultar os aceleradores de
teclado.
(Herdado de Control )
Mostrar Dicas de Ferramentas Obtém ou define um valor que indica que as dicas de
de Nó ferramentas são mostradas quando o ponteiro do mouse passa
sobre um TreeNode .
Mostrar Mais Menos Obtém ou define um valor que indica se os botões de sinal de
adição (+) e sinal de subtração (-) são exibidos próximos aos nós
de árvore que contêm nós de árvore filho.
Mostrar linhas de raiz Obtém ou define um valor que indica se as linhas são
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 13/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Lista de imagens de estado Obtém ou define a lista de imagens usada para indicar o estado
do TreeView e seus nós.
Parada de tabulação Obtém ou define um valor que indica se o usuário pode dar foco
a esse controle usando a tecla TAB.
(Herdado de Control )
Controle de nível superior Obtém o controle pai que não é pai de outro controle Windows
Forms. Normalmente, este é o Form mais externo no qual o
controle está contido.
(Herdado de Control )
Usar Cursor de Espera Obtém ou define um valor que indica se o cursor de espera deve
ser usado para o controle atual e todos os controles filho.
(Herdado de Control )
Contagem Visível Obtém o número de nós de árvore que podem ser totalmente
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 14/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Métodos
Clientes de Notificação de Notifica os aplicativos cliente de acessibilidade dos
Acessibilidade (Eventos AccessibleEvents especificados para o controle filho
Acessíveis , Int32) especificado.
(Herdado de Control )
Criar Instância de Controles () Cria uma nova instância da coleção de controle para o controle.
(Herdado de Control )
Criar Ref. Obj (Tipo) Cria um objeto que contém todas as informações relevantes
necessárias para gerar um proxy usado para se comunicar com
um objeto remoto.
(Herdado de MarshalByRefObject )
Obter modo de tamanho Recupera um valor que indica como um controle se comportará
automático () quando sua propriedade AutoSize estiver habilitada.
(Herdado de Control )
Get Child AtPoint (Ponto, Get Recupera o controle filho localizado nas coordenadas
Child AtPoint Skip) especificadas, especificando se os controles filho de um
determinado tipo devem ser ignorados.
(Herdado de Control )
Obter serviço vitalício () Recupera o objeto de serviço de tempo de vida atual que
controla a política de tempo de vida para esta instância.
(Herdado de MarshalByRefObject )
Obter o próximo controle Recupera o próximo controle para frente ou para trás na ordem
(controle, booleano) de tabulação dos controles filhos.
(Herdado de Control )
Obter limites dimensionados Recupera os limites dentro dos quais o controle é dimensionado.
(retângulo, tamanho F, limites (Herdado de Control )
especificados)
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 17/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Obter serviço (tipo) Retorna um objeto que representa um serviço fornecido pelo
Componente ou por seu Container .
(Herdado de Componente )
Obter estilo ( estilos de Recupera o valor do bit de estilo de controle especificado para o
controle) controle.
(Herdado de Control )
Inicializar serviço vitalício () Obtém um objeto de serviço de tempo de vida para controlar a
política de tempo de vida desta instância.
(Herdado de MarshalByRefObject )
Invalidar (Booleano) Invalida uma região específica do controle e faz com que uma
mensagem de pintura seja enviada ao controle. Opcionalmente,
invalida os controles filhos atribuídos ao controle.
(Herdado de Control )
Unidades lógicas para Converte um valor DPI lógico em seu valor DeviceUnit DPI
dispositivos (Int32) equivalente.
(Herdado de Control )
Clone membro a membro Cria uma cópia superficial do objeto MarshalByRefObject atual .
(booleano) (Herdado de MarshalByRefObject )
Notificar Invalidar (Retângulo) Gera o evento Invalidated com uma região especificada do
controle para invalidar.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 20/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 21/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 22/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 24/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
(Herdado de Control )
Fonte principal alterada ( Args Gera o evento FontChanged quando o valor da propriedade
do evento) Font do contêiner do controle é alterado.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 25/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Apontar para a tela (apontar) Calcula a localização do ponto do cliente especificado nas
coordenadas da tela.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 26/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 27/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Redefinir cor traseira () Redefine a propriedade BackColor para seu valor padrão.
(Herdado de Control )
Redefinir Cor Fore () Redefine a propriedade ForeColor para seu valor padrão.
(Herdado de Control )
Reiniciar modo IME () Redefine a propriedade ImeMode para seu valor padrão.
(Herdado de Control )
Redefinir Direita Para Redefine a propriedade RightToLeft para seu valor padrão.
Esquerda() (Herdado de Control )
Redefinir Texto() Redefine a propriedade Text para seu valor padrão ( Empty ).
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 28/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Dimensionar bitmap lógico Dimensiona um valor de bitmap lógico para seu valor de
para dispositivo (bitmap) unidade de dispositivo equivalente quando ocorre uma
alteração de DPI.
(Herdado de Control )
Núcleo de escala (único, Este método não é relevante para esta classe.
único) (Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 29/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Definir modo de tamanho Define um valor que indica como um controle se comportará
automático ( modo de quando sua propriedade AutoSize estiver habilitada.
tamanho automático ) (Herdado de Control )
Definir limites (Int32, Int32, Define os limites do controle para o local e tamanho
Int32, Int32) especificados.
(Herdado de Control )
Definir limites (Int32, Int32, Define os limites especificados do controle para o local e
Int32, Int32, limites tamanho especificados.
especificados) (Herdado de Control )
Definir Limites Núcleo (Int32, Executa o trabalho de definir os limites especificados desse
Int32, Int32, Int32, Limites controle.
Especificados) (Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 30/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Limites de atualização (Int32, Atualiza os limites do controle com o tamanho, local e tamanho
Int32, Int32, Int32, Int32, do cliente especificados.
Int32) (Herdado de Control )
Eventos
Depois da Verificação Ocorre depois que a caixa de seleção do nó da árvore é
marcada.
Após a edição do rótulo Ocorre depois que o texto do rótulo do nó da árvore é editado.
Tamanho automático alterado Este evento não é relevante para esta classe.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 31/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Antes da Edição do Rótulo Ocorre antes que o texto do rótulo do nó da árvore seja editado.
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 32/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
(Herdado de Control )
Dpi alterado após pai Ocorre quando a configuração de DPI de um controle é alterada
programaticamente após a alteração do DPI de seu controle pai
ou formulário.
(Herdado de Control )
Dpi alterado antes do pai Ocorre quando a configuração de DPI para um controle é
alterada programaticamente antes que ocorra um evento de
alteração de DPI para seu controle pai ou formulário.
(Herdado de Control )
Arrastar Sair Ocorre quando um objeto é arrastado para fora dos limites do
controle.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 33/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
tecla para baixo Ocorre quando uma tecla é pressionada enquanto o controle
está em foco.
(Herdado de Control )
Tecla para cima Ocorre quando uma tecla é liberada enquanto o controle está
em foco.
(Herdado de Control )
Clique duplo do mouse Ocorre quando o controle é clicado duas vezes pelo mouse.
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 34/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
(Herdado de Control )
Mouse para baixo Ocorre quando o ponteiro do mouse está sobre o controle e um
botão do mouse é pressionado.
(Herdado de Control )
Mouse para cima Ocorre quando o ponteiro do mouse está sobre o controle e um
botão do mouse é liberado.
(Herdado de Control )
Node Mouse Clique Duplo Ocorre quando o usuário clica duas vezes em um TreeNode com
o mouse.
Preview Key Down Ocorre antes do evento KeyDown quando uma tecla é
pressionada enquanto o foco está neste controle.
(Herdado de Control )
Consulta Continuar Arrastar Ocorre durante uma operação de arrastar e soltar e permite que
a fonte de arrastar determine se a operação de arrastar e soltar
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 35/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 36/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn
Aplica-se a
produtos Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2,
4.8, 4.8.1
Veja também
TreeNode
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 37/37