Você está na página 1de 37

15/03/2023 15:20 Classe TreeView (System.Windows.

Forms) | Microsoft Learn

Classe de Visualização em Árvore


Referência

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

Exibe uma coleção hierárquica de itens rotulados, cada um representado por um


TreeNode .

C#

[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class TreeView : System.Windows.Forms.Control

Herança Objeto → MarshalByRefObject → Componente → Ao controle → TreeView

derivado Sistema. Modelo de componentes . Projeto. Editor de Seletor de Objetos .


Seletor

Atributos Atributo de ancoragem

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#

// Populates a TreeView control with example nodes.


private void InitializeTreeView()
{
treeView1.BeginUpdate();
treeView1.Nodes.Add("Parent");
treeView1.Nodes[0].Nodes.Add("Child 1");
treeView1.Nodes[0].Nodes.Add("Child 2");
treeView1.Nodes[0].Nodes[1].Nodes.Add("Grandchild");
treeView1.Nodes[0].Nodes[1].Nodes[0].Nodes.Add("Great Grandchild");
treeView1.EndUpdate();
}

O exemplo de código mais complexo a seguir exibe informações do cliente em um


controle TreeView . Os nós da árvore raiz exibem os nomes dos clientes e os nós da
árvore filha exibem os números dos pedidos atribuídos a cada cliente. Neste exemplo,
1.000 clientes são exibidos com 15 pedidos cada. A repintura do TreeView é suprimida
usando os métodos BeginUpdate e EndUpdate , e um cursor de espera é exibido
enquanto o TreeView cria e pinta os objetos TreeNode . Este exemplo requer que você
tenha um Customer objeto que possa conter uma coleção de Order objetos. Também
requer que você tenha um arquivo de cursor chamado MyWait.cur no diretório do
aplicativo e que você criou uma instância de um controle TreeView em um Form .

C#

// The basic Customer class.


public class Customer : System.Object
{
private string custName = "";
protected ArrayList custOrders = new ArrayList();

public Customer(string customername)


{
this.custName = customername;
}

public string CustomerName


{
get{return this.custName;}
set{this.custName = value;}
}

public ArrayList CustomerOrders


{
get{return this.custOrders;}
}
} // End Customer class

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

// The basic customer Order class.


public class Order : System.Object
{
private string ordID = "";

public Order(string orderid)


{
this.ordID = orderid;
}

public string OrderID


{
get{return this.ordID;}
set{this.ordID = value;}
}
} // End Order class

// Create a new ArrayList to hold the Customer objects.


private ArrayList customerArray = new ArrayList();

private void FillMyTreeView()


{
// Add customers to the ArrayList of Customer objects.
for(int x=0; x<1000; x++)
{
customerArray.Add(new Customer("Customer" + x.ToString()));
}

// Add orders to each Customer object in the ArrayList.


foreach(Customer customer1 in customerArray)
{
for(int y=0; y<15; y++)
{
customer1.CustomerOrders.Add(new Order("Order" + y.ToString()));
}
}

// Display a wait cursor while the TreeNodes are being created.


Cursor.Current = new Cursor("MyWait.cur");

// Suppress repainting the TreeView until all the objects have been
created.
treeView1.BeginUpdate();

// Clear the TreeView each time the method is called.


treeView1.Nodes.Clear();

// Add a root TreeNode for each Customer object in the ArrayList.


foreach(Customer customer2 in customerArray)
{
treeView1.Nodes.Add(new TreeNode(customer2.CustomerName));

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

// Reset the cursor to the default for all controls.


Cursor.Current = Cursors.Default;

// Begin repainting the TreeView.


treeView1.EndUpdate();
}

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:

Configure a propriedade ImageIndex para o valor de índice da imagem que você


deseja exibir quando um nó de árvore não estiver selecionado.

Configure a propriedade SelectedImageIndex para o valor de índice da imagem


que você deseja exibir quando um nó de árvore for selecionado.

As imagens referenciadas pelos valores de propriedade ImageIndex e


SelectedImageIndex são as imagens padrão exibidas por todos os nós da árvore
atribuídos à coleção Nodes . Os nós de árvore individuais podem substituir as imagens
padrão configurando as propriedades TreeNode.ImageIndex e
TreeNode.SelectedImageIndex .

As imagens de estado exibidas no TreeView são 16 x 16 pixels por padrão. Definir a


propriedade ImageSize do StateImageList não terá nenhum efeito sobre como as
imagens são exibidas. No entanto, as imagens de estado são redimensionadas de

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

acordo com a configuração de DPI do sistema quando o arquivo app.config contém a


seguinte entrada:

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

Definir a propriedade TreeNode.Checked de dentro do evento BeforeCheck ou


AfterCheck faz com que o evento seja gerado várias vezes e pode resultar em
comportamento inesperado. Por exemplo, você pode definir a propriedade
Checked no manipulador de eventos quando estiver atualizando recursivamente os
nós filho para que o usuário não precise expandir e verificar cada um
individualmente. Para evitar que o evento seja gerado várias vezes, adicione lógica
ao seu manipulador de eventos que só executa seu código recursivo se a
propriedade Action do TreeViewEventArgs não estiver definida como
TreeViewAction.Unknown . Para obter um exemplo de como fazer isso, consulte a
seção Exemplo do AfterCheckou eventos BeforeCheck .

Você pode alterar a aparência do controle TreeView definindo algumas de suas


propriedades de exibição e estilo. Definir ShowPlusMinus como true exibe um botão de
sinal de mais ou menos ao lado de cada TreeNode que pode ser expandido ou
recolhido, respectivamente. Definir a propriedade ShowRootLines true como faz com
que o TreeView exiba linhas que unem todos os nós da árvore raiz. Você pode exibir
linhas que conectam os nós da árvore filho ao nó raiz definindo a propriedade

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

ShowLines true como . Definindo a propriedade HotTracking como true altera a


aparência dos rótulos dos nós da árvore à medida que o ponteiro do mouse passa
sobre eles. Quando rastreados a quente, os rótulos dos nós da árvore assumem a
aparência de um hiperlink. Você também pode personalizar completamente a aparência
do controle TreeView . Para fazer isso, defina a propriedade DrawMode com um valor
diferente de TreeViewDrawMode.Normal e manipule o evento DrawNode .

7 Observação

Ao definir as propriedades CheckBoxes , Scrollable , ImageIndex e


SelectedImageIndex em tempo de execução, o identificador TreeView é recriado
(consulte Control.RecreateHandle ) para atualizar a aparência do controle. Isso faz
com que todos os nós da árvore sejam recolhidos, exceto o TreeNode selecionado
.

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 )

Descrição Acessível Obtém ou define a descrição do controle usado por aplicativos


cliente de acessibilidade.
(Herdado de Control )

Nome Acessível Obtém ou define o nome do controle usado por aplicativos


cliente de acessibilidade.
(Herdado de Control )

função acessível Obtém ou define a função acessível do controle.


(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

Âncora Obtém ou define as bordas do contêiner ao qual um controle


está vinculado e determina como um controle é redimensionado
com seu pai.
(Herdado de Control )

Deslocamento Automático de Obtém ou define para onde esse controle é rolado em


Rolagem ScrollControlIntoView(Control) .
(Herdado de Control )

Tamanho automático Esta propriedade não é relevante para esta classe.


(Herdado de Control )

Cor de fundo Obtém ou define a cor de fundo do controle.

Imagem de fundo Obtém ou define a imagem de plano de fundo do controle


TreeView .

Layout da Imagem de Fundo Obtém ou define o layout da imagem de plano de fundo do


controle TreeView .

Contexto de ligação Obtém ou define o BindingContext para o controle.


(Herdado de Control )

Estilo de Borda Obtém ou define o estilo de borda do controle de exibição em


árvore.

Fundo Obtém a distância, em pixels, entre a borda inferior do controle


e a borda superior da área cliente do contêiner.
(Herdado de Control )

Limites Obtém ou define o tamanho e a localização do controle,


incluindo seus elementos não clientes, em pixels, relativos ao
controle pai.
(Herdado de Control )

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 gerar eventos Determina se os eventos podem ser gerados no controle.


(Herdado de Control )

Pode selecionar Obtém um valor que indica se o controle pode ser selecionado.
(Herdado de Control )

Capturar Obtém ou define um valor que indica se o controle capturou o


mouse.
(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.

Cliente Retângulo Obtém o retângulo que representa a área cliente do controle.


(Herdado de Control )

Tamanho do cliente Obtém ou define a altura e a largura da área do cliente do


controle.
(Herdado de Control )

Nome da empresa Obtém o nome da empresa ou criador do aplicativo que contém


o controle.
(Herdado de Control )

Recipiente Obtém o IContainer que contém o Component .


(Herdado de Componente )

contém foco Obtém um valor que indica se o controle ou um de seus


controles filho tem o foco de entrada no momento.
(Herdado de Control )

Menu de Contexto Obtém ou define o menu de atalho associado ao controle.


(Herdado de Control )

Faixa do Menu de Contexto Obtém ou define o ContextMenuStrip associado a este controle.


(Herdado de Control )

Controles Obtém a coleção de controles contidos no controle.


(Herdado de Control )

Criada Obtém um valor que indica se o controle foi criado.


(Herdado de Control )

Criar parâmetros Obtém os parâmetros de criação necessários quando o


identificador de controle é criado.

Cursor Obtém ou define o cursor exibido quando o ponteiro do mouse


está sobre o controle.
(Herdado de Control )

Ligações de dados Obtém as associações de dados para o controle.


(Herdado de Control )

Contexto de Dados Obtém ou define o contexto de dados para fins de vinculação de


dados. Esta é uma propriedade do ambiente.
(Herdado de Control )

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

Cursor Padrão Obtém ou define o cursor padrão para o controle.


(Herdado de Control )

Modo Ime padrão Obtém o modo Input Method Editor (IME) padrão com suporte
no controle.
(Herdado de Control )

Margem Padrão Obtém o espaço, em pixels, especificado por padrão entre os


controles.
(Herdado de Control )

Tamanho máximo padrão Obtém o comprimento e a altura, em pixels, especificados como


o tamanho máximo padrão de um controle.
(Herdado de Control )

Tamanho mínimo padrão Obtém o comprimento e a altura, em pixels, especificados como


o tamanho mínimo padrão de um controle.
(Herdado de Control )

Preenchimento Padrão Obtém o espaçamento interno, em pixels, do conteúdo de um


controle.
(Herdado de Control )

Tamanho padrão Obtém o tamanho padrão do controle.

Modo de design Obtém um valor que indica se o Component está atualmente no


modo de design.
(Herdado de Componente )

Dpi do dispositivo Obtém o valor de DPI para o dispositivo de exibição em que o


controle está sendo exibido no momento.
(Herdado de Control )

Exibição Retângulo Obtém o retângulo que representa a área de exibição do


controle.
(Herdado de Control )

Descartando Obtém um valor que indica se a classe Control base está em


processo de descarte.
(Herdado de Control )

Doca Obtém ou define quais bordas de controle são encaixadas em


seu controle pai e determina como um controle é
redimensionado com seu pai.
(Herdado de Control )

Buffer Duplo Obtém ou define um valor que indica se o controle deve


redesenhar sua superfície usando um buffer secundário. A
propriedade DoubleBuffered não afeta o controle TreeView .

Modo de desenho Obtém ou define o modo no qual o controle é desenhado.

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

Habilitado Obtém ou define um valor que indica se o controle pode


responder à interação do usuário.
(Herdado de Control )

Eventos Obtém a lista de manipuladores de eventos anexados a este


Component .
(Herdado de Componente )

Focado Obtém um valor que indica se o controle tem foco de entrada.


(Herdado de Control )

Fonte Obtém ou define a fonte do texto exibido pelo controle.


(Herdado de Control )

Altura da fonte Obtém ou define a altura da fonte do controle.


(Herdado de Control )

Cor da Frente Obtém ou define a cor de primeiro plano do controle.

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.

Lidar Obtém o identificador de janela ao qual o controle está


associado.
(Herdado de Control )

tem filhos Obtém um valor que indica se o controle contém um ou mais


controles filho.
(Herdado de Control )

Altura Obtém ou define a altura do controle.


(Herdado de Control )

Ocultar Seleção Obtém ou define um valor que indica se o nó de árvore


selecionado permanece realçado mesmo quando a exibição em
árvore perdeu o foco.

Hot Tracking Obtém ou define um valor que indica se um rótulo de nó de


árvore assume a aparência de um hiperlink conforme o ponteiro
do mouse passa sobre ele.

Índice de imagens Obtém ou define o valor do índice da lista de imagens da


imagem padrão exibida pelos nós da árvore.

Chave de Imagem Obtém ou define a chave da imagem padrão para cada nó no


controle TreeView quando ele está em um estado não
selecionado.

Lista de imagens Obtém ou define o ImageList que contém os objetos Image


usados ​pelos nós da árvore.

Modo Ime Obtém ou define o modo Input Method Editor (IME) do

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 )

Base do Modo Ime Obtém ou define o modo IME de um controle.


(Herdado de Control )

Recuar Obtém ou define a distância para recuar cada nível de nó da


árvore filho.

Invocar Necessário Obtém um valor que indica se o chamador deve chamar um


método de chamada ao fazer chamadas de método para o
controle porque o chamador está em um thread diferente
daquele em que o controle foi criado.
(Herdado de Control )

é acessível Obtém ou define um valor que indica se o controle está visível


para aplicativos de acessibilidade.
(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 )

está descartado Obtém um valor que indica se o controle foi descartado.


(Herdado de Control )

Identificador criado _ Obtém um valor que indica se o controle tem um identificador


associado a ele.
(Herdado de Control )

é espelhado Obtém um valor que indica se o controle é espelhado.


(Herdado de Control )

Altura do Item Obtém ou define a altura de cada nó de árvore no controle de


exibição de árvore.

Editar etiqueta Obtém ou define um valor que indica se o texto do rótulo dos
nós da árvore pode ser editado.

Motor de Layout Obtém uma instância em cache do mecanismo de layout do


controle.
(Herdado de Control )

Esquerda Obtém ou define a distância, em pixels, entre a borda esquerda


do controle e a borda esquerda da área cliente de seu contêiner.
(Herdado de Control )

Cor da linha Obtém ou define a cor das linhas que conectam os nós do
controle TreeView .

Localização Obtém ou define as coordenadas do canto superior esquerdo


do controle em relação ao canto superior esquerdo de seu

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 )

Margem Obtém ou define o espaço entre os controles.


(Herdado de Control )

Tamanho Máximo Obtém ou define o tamanho que é o limite superior que


GetPreferredSize(Size) pode especificar.
(Herdado de Control )

Tamanho Mínimo Obtém ou define o tamanho que é o limite inferior que


GetPreferredSize(Size) pode especificar.
(Herdado de Control )

Nome Obtém ou define o nome do controle.


(Herdado de Control )

Nós Obtém a coleção de nós de árvore atribuídos ao controle de


exibição de árvore.

Preenchimento Obtém ou define o espaçamento entre o conteúdo do controle


TreeView e suas bordas.

Pai Obtém ou define o contêiner pai do controle.


(Herdado de Control )

Separador de caminho Obtém ou define a string delimitadora que o caminho do nó da


árvore usa.

Tamanho preferido Obtém o tamanho de uma área retangular na qual o controle


pode caber.
(Herdado de Control )

Nome do produto Obtém o nome do produto do assembly que contém o controle.


(Herdado de Control )

Versão do produto Obtém a versão do assembly que contém o controle.


(Herdado de Control )

Recriando identificador Obtém um valor que indica se o controle está recriando seu
identificador no momento.
(Herdado de Control )

Região Obtém ou define a região da janela associada ao controle.


(Herdado de Control )

Renderizar da direita para a Obsoleto.


esquerda Esta propriedade agora está obsoleta.
(Herdado de Control )

Redimensionar Redesenhar Obtém ou define um valor que indica se o controle é


redesenhado quando redimensionado.

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 )

Certo Obtém a distância, em pixels, entre a borda direita do controle e


a borda esquerda da área cliente de seu contêiner.
(Herdado de Control )

Direita Para Esquerda Obtém ou define um valor que indica se os elementos do


controle estão alinhados para oferecer suporte a localidades
usando fontes da direita para a esquerda.
(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.

Escala Crianças Obtém um valor que determina o dimensionamento dos


controles filho.
(Herdado de Control )

Rolável Obtém ou define um valor que indica se o controle de exibição


em árvore exibe barras de rolagem quando elas são necessárias.

Índice de imagens Obtém ou define o valor do índice da lista de imagens da


selecionadas imagem que é exibida quando um nó de árvore é selecionado.

Chave de imagem Obtém ou define a chave da imagem padrão mostrada quando


selecionada um TreeNode está em um estado selecionado.

Nó Selecionado Obtém ou define o nó de árvore atualmente selecionado no


controle de exibição de árvore.

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 Linhas Obtém ou define um valor que indica se as linhas são


desenhadas entre nós de árvore no controle de exibição de
árvore.

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

desenhadas entre os nós da árvore que estão na raiz da exibição


em árvore.

Site Obtém ou define o site do controle.


(Herdado de Control )

Tamanho Obtém ou define a altura e a largura do controle.


(Herdado de Control )

Ordenado Obtém ou define um valor que indica se os nós da árvore na


exibição em árvore estão classificados.

Lista de imagens de estado Obtém ou define a lista de imagens usada para indicar o estado
do TreeView e seus nós.

Índice de guias Obtém ou define a ordem de tabulação do controle em seu


contêiner.
(Herdado de Control )

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 )

Marcação Obtém ou define o objeto que contém dados sobre o controle.


(Herdado de Control )

Texto Obtém ou define o texto do TreeView .

Principal Obtém ou define a distância, em pixels, entre a borda superior


do controle e a borda superior da área cliente do contêiner.
(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 )

Nó Superior Obtém ou define o primeiro nó de árvore totalmente visível no


controle de exibição de árvore.

Classificador de Nó de Obtém ou define a implementação de IComparer para executar


Visualização em Árvore uma classificação personalizada dos nós TreeView .

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 )

Visível Obtém ou define um valor que indica se o controle e todos os


seus controles filho são exibidos.
(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

visíveis no controle de exibição de árvore.

Largura Obtém ou define a largura do controle.


(Herdado de Control )

Alvo da Janela Esta propriedade não é relevante para esta classe.


(Herdado de Control )

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 )

Clientes de Notificação de Notifica os aplicativos cliente de acessibilidade dos


Acessibilidade ( Eventos AccessibleEvents especificados para o controle filho
Acessíveis, Int32, Int32) especificado.
(Herdado de Control )

Começar a invocar (ação) Executa o delegado especificado de forma assíncrona no thread


em que o identificador subjacente do controle foi criado.
(Herdado de Control )

Começar a invocar (delegar) Executa o delegado especificado de forma assíncrona no thread


em que o identificador subjacente do controle foi criado.
(Herdado de Control )

Begin Invoke(Delegate, Executa o delegado especificado de forma assíncrona com os


Object[]) argumentos especificados, no thread em que o identificador
subjacente do controle foi criado.
(Herdado de Control )

Iniciar atualização() Desativa qualquer redesenho da visualização em árvore.

Traga para a frente () Traz o controle para a frente da ordem z.


(Herdado de Control )

Recolher tudo() Recolhe todos os nós da árvore.

Contém(Controle) Recupera um valor que indica se o controle especificado é um


filho do controle.
(Herdado de Control )

Criar Instância de Cria a nova instância de AccessibleObject para este controle


Acessibilidade () TreeView.

Criar Controle() Força a criação do controle visível, incluindo a criação do


identificador e quaisquer controles filhos visíveis.
(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 15/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn

Criar Instância de Controles () Cria uma nova instância da coleção de controle para o controle.
(Herdado de Control )

Criar Gráficos() Cria os gráficos para o controle.


(Herdado de Control )

Criar identificador () Cria um identificador para o controle.

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 )

Def Wnd Proc(Mensagem) Envia a mensagem especificada para o procedimento de janela


padrão.
(Herdado de Control )

Destruir Alça() Destrói o identificador associado ao controle.


(Herdado de Control )

Dispose() Libera todos os recursos utilizados pelo Componente .


(Herdado de Componente )

Dispor (Booleano) Libera os recursos não gerenciados usados ​pelo TreeView e,


opcionalmente, libera os recursos gerenciados.

Arrastar e soltar (objeto, Inicia uma operação de arrastar e soltar.


efeitos de arrastar e soltar ) (Herdado de Control )

Arrastar e soltar (objeto, Inicia uma operação de arrastar.


efeitos de arrastar e soltar , (Herdado de Control )
bitmap, ponto, booleano)

Desenhar ToBitmap(Bitmap, Oferece suporte à renderização no bitmap especificado.


Retângulo) (Herdado de Control )

Fim da chamada ( resultado Recupera o valor de retorno da operação assíncrona


do IAsync) representada pelo IAsyncResult passado.
(Herdado de Control )

Finalizar atualização() Permite redesenhar a visualização em árvore.

Igual a (objeto) Determina se o objeto especificado é igual ao objeto atual.


(Herdado de Object )

Expandir tudo() Expande todos os nós da árvore.

Localizar Formulário() Recupera o formulário em que o controle está ativado.


(Herdado de Control )

Foco() Define o foco de entrada para o controle.


(Herdado de Control )
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 16/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn

Obter objeto de Recupera o AccessibleObject especificado .


acessibilidade ById(Int32) (Herdado de Control )

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 )

Obter Criança AtPoint(Point) Recupera o controle filho localizado nas coordenadas


especificadas.
(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 controle de contêiner () Retorna o próximo ContainerControl na cadeia de controles pai


do controle.
(Herdado de Control )

Obter código hash () Serve como a função de hash padrão.


(Herdado de Object )

Obter estilos de renderização Retorna um OwnerDrawPropertyBag para o TreeNode


de item ( nó de árvore, Int32) especificado .

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 nó em (Int32, Int32) Recupera o nó da árvore no ponto com as coordenadas


especificadas.

Obter nó em (ponto) Recupera o nó da árvore que está no ponto especificado.

Obter contagem de nós Recupera o número de nós da árvore, incluindo opcionalmente


(booleano) aqueles em todas as subárvores, atribuídos ao controle de
visualização da árvore.

Obtenha o tamanho preferido Recupera o tamanho de uma área retangular na qual um


(tamanho) controle pode ser encaixado.
(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 )

Obter nível superior () Determina se o controle é um controle de nível superior.


(Herdado de Control )

Obter tipo() Obtém o Type da instância atual.


(Herdado de Object )

Esconder() Oculta o controle do usuário.


(Herdado de Control )

Teste de acerto (Int32, Int32) Fornece informações do nó, dadas as coordenadas x e y.

Teste de acerto (ponto) Fornece informações de nó, dado um ponto.

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 )

Iniciar layout() Chamado depois que o controle foi adicionado a outro


contêiner.
(Herdado de Control )

Invalidar() Invalida toda a superfície do controle e faz com que o controle


seja redesenhado.
(Herdado de Control )

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 )

Invalidar (Retângulo) Invalida a região especificada do controle (adiciona-a à região


de atualização do controle, que é a área que será repintada na
próxima operação de pintura) e faz com que uma mensagem de
pintura seja enviada ao controle.
(Herdado de Control )

Invalidar (Retângulo, Invalida a região especificada do controle (adiciona-a à região


Booleano) de atualização do controle, que é a área que será repintada na
próxima operação de pintura) e faz com que uma mensagem de
pintura seja enviada ao controle. Opcionalmente, invalida os
controles filhos atribuídos ao controle.
(Herdado de Control )

Invalidar(Região) Invalida a região especificada do controle (adiciona-a à região


https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 18/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn

de atualização do controle, que é a área que será repintada na


próxima operação de pintura) e faz com que uma mensagem de
pintura seja enviada ao controle.
(Herdado de Control )

Invalidate(Região, Booleano) Invalida a região especificada do controle (adiciona-a à região


de atualização do controle, que é a área que será repintada na
próxima operação de pintura) e faz com que uma mensagem de
pintura seja enviada ao controle. Opcionalmente, invalida os
controles filhos atribuídos ao controle.
(Herdado de Control )

Invocar (ação) Executa o delegado especificado no thread que possui o


identificador de janela subjacente do controle.
(Herdado de Control )

Invocar (Delegar) Executa o delegado especificado no thread que possui o


identificador de janela subjacente do controle.
(Herdado de Control )

Invoke(Delegate, Object[]) Executa o delegado especificado, no thread que possui o


identificador de janela subjacente do controle, com a lista de
argumentos especificada.
(Herdado de Control )

Chamar<T>(Func<T>) Executa o delegado especificado no thread que possui o


identificador de janela subjacente do controle.
(Herdado de Control )

Invoke Got Focus(Control, Gera o evento GotFocus para o controle especificado.


Event Args) (Herdado de Control )

Chamar Foco Perdido Gera o evento LostFocus para o controle especificado.


(Controle, Args de Evento) (Herdado de Control )

Invocar OnClick (controle, Gera o evento Click para o controle especificado.


argumentos do evento) (Herdado de Control )

Chamar pintura (controle, Gera o evento Paint para o controle especificado.


argumentos de evento de (Herdado de Control )
pintura )

Invocar fundo de pintura Gera o PaintBackground evento para o controle especificado.


(controle, argumentos de (Herdado de Control )
evento de pintura )

É o caractere de entrada Determina se um caractere é um caractere de entrada que o


(caractere) controle reconhece.
(Herdado de Control )

É a chave de entrada (teclas) Determina se a chave especificada é uma chave de entrada


regular ou uma chave especial que requer pré-processamento.
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 19/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn

Unidades lógicas para Converte um valor DPI lógico em seu valor DeviceUnit DPI
dispositivos (Int32) equivalente.
(Herdado de Control )

Unidades lógicas para Transforma um tamanho de lógico em unidades de dispositivo,


dispositivos (tamanho) dimensionando-o para o DPI atual e arredondando para o valor
inteiro mais próximo para largura e altura.
(Herdado de Control )

Clone de membros () Cria uma cópia superficial do Object atual .


(Herdado de Object )

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 )

Após a verificação ( args do Gera o evento AfterCheck .


evento de visualização em
árvore )

Após o colapso ( Args do Gera o evento AfterCollapse .


evento de visualização em
árvore )

On After Expand ( args de Gera o evento AfterExpand .


evento de visualização em
árvore )

Após a edição do rótulo ( Gera o evento AfterLabelEdit .


argumentos do evento de
edição do rótulo do nó)

On After Select ( args de Gera o evento AfterSelect .


evento de visualização em
árvore )

On Auto Size Changed (Event Gera o evento AutoSizeChanged .


Args) (Herdado de Control )

Na cor traseira alterada ( Args Gera o evento BackColorChanged .


do evento) (Herdado de Control )

Na imagem de fundo alterada Gera o evento BackgroundImageChanged .


( Args do evento) (Herdado de Control )

No layout da imagem de Gera o evento BackgroundImageLayoutChanged .


plano de fundo alterado ( (Herdado de Control )
Args do evento)

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

On Before Check (Tree View Gera o evento BeforeCheck .


Cancel Event Args)

On Before Collapse (Tree View Gera o evento BeforeCollapse .


Cancel Event Args)

On Before Expand (Tree View Gera o evento BeforeExpand .


Cancel Event Args)

Antes da edição do rótulo ( Gera o evento BeforeLabelEdit .


argumentos do evento de
edição do rótulo do nó )

On Before Select (Tree View Gera o evento BeforeSelect .


Cancel Event Args)

No contexto de vinculação Gera o evento BindingContextChanged .


alterado ( Args do evento) (Herdado de Control )

Na validação das causas Gera o evento CausesValidationChanged .


alteradas ( Args do evento) (Herdado de Control )

Ao alterar UICues ( args de Gera o evento ChangeUICues .


evento UICues ) (Herdado de Control )

Ao clicar ( Args do evento) Gera o evento Click .


(Herdado de Control )

Tamanho do cliente alterado ( Gera o evento ClientSizeChanged .


Args do evento) (Herdado de Control )

No menu de contexto Gera o evento ContextMenuChanged .


alterado ( Args do evento) (Herdado de Control )

Na faixa do menu de contexto Gera o evento ContextMenuStripChanged .


alterada ( Args do evento) (Herdado de Control )

No controle adicionado ( Args Gera o evento ControlAdded .


de evento de controle ) (Herdado de Control )

No controle removido ( Gera o evento ControlRemoved .


argumentos de evento de (Herdado de Control )
controle )

Ao criar controle() Gera o método CreateControl() .


(Herdado de Control )

OnCursorChanged(EventArgs) Raises the CursorChanged event.


(Inherited from Control)

OnDataContext (Inherited from Control)


Changed(EventArgs)

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

OnDockChanged(EventArgs) Raises the DockChanged event.


(Inherited from Control)

OnDoubleClick(EventArgs) Raises the DoubleClick event.


(Inherited from Control)

OnDpiChangedAfter Raises the DpiChangedAfterParent event.


Parent(EventArgs) (Inherited from Control)

Em Dpi alterado antes do pai ( Gera o evento DpiChangedBeforeParent .


Args do evento) (Herdado de Control )

Ao arrastar e soltar ( Args do Gera o evento DragDrop .


evento de arrastar ) (Herdado de Control )

Ao arrastar Enter (arrastar Gera o evento DragEnter .


argumentos do evento ) (Herdado de Control )

Ao arrastar sair ( args do Gera o evento DragLeave .


evento) (Herdado de Control )

Ao arrastar (arrastar Gera o evento DragOver .


argumentos do evento ) (Herdado de Control )

No nó de desenho ( Gera o evento DrawNode .


argumentos do evento do nó
de árvore de desenho )

On Enabled Changed(Event Gera o evento EnabledChanged .


Args) (Herdado de Control )

Ao entrar ( args do evento) Gera o evento Enter .


(Herdado de Control )

Fonte alterada ( Args do Gera o evento FontChanged .


evento) (Herdado de Control )

Na Cor Fore Changed (Event Gera o evento ForeColorChanged .


Args) (Herdado de Control )

Em dar feedback ( args de Gera o evento GiveFeedback .


evento de dar feedback ) (Herdado de Control )

Obteve foco ( argumentos do evento)

No identificador criado ( Args Substitui OnHandleCreated(EventArgs) .


do evento)

No identificador destruído ( Substitui OnHandleDestroyed(EventArgs) .


Args do evento)

Na ajuda solicitada ( Gera o evento HelpRequested .

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

argumentos do evento de (Herdado de Control )


ajuda )

No modo IME alterado ( Args Gera o evento ImeModeChanged .


do evento) (Herdado de Control )

Em invalidado (invalidar Gera o evento Invalidated .


argumentos de evento ) (Herdado de Control )

Ao arrastar o item ( Args do Gera o evento ItemDrag .


evento de arrastar do item )

On Key Down (Key Event Gera o evento KeyDown .


Args)

Ao pressionar a tecla ( args de Gera o evento KeyPress .


evento de pressionamento de
tecla )

On Key Up (Key Event Args) Substitui OnKeyUp(KeyEventArgs) .

No layout ( argumentos do Gera o evento Layout .


evento de layout ) (Herdado de Control )

Em Licença ( Argumentos de Gera o evento Leave .


Evento) (Herdado de Control )

No local alterado ( Gera o evento LocationChanged .


argumentos do evento) (Herdado de Control )

Em Foco Perdido ( Argumentos de Evento)

Na margem alterada ( Gera o evento MarginChanged .


argumentos do evento) (Herdado de Control )

Na captura do mouse Gera o evento MouseCaptureChanged .


alterada ( Args do evento) (Herdado de Control )

No clique do mouse ( args de Gera o evento MouseClick .


evento do mouse ) (Herdado de Control )

Ao clicar duas vezes no Gera o evento MouseDoubleClick .


mouse ( args do evento do (Herdado de Control )
mouse )

Ao pressionar o mouse ( args Gera o evento MouseDown .


de evento do mouse ) (Herdado de Control )

Ao pressionar o mouse Enter ( Gera o evento MouseEnter .


args do evento) (Herdado de Control )

Ao passar o mouse (evento Gera o evento MouseHover .


Args)
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 23/37
15/03/2023 15:20 Classe TreeView (System.Windows.Forms) | Microsoft Learn

Na saída do mouse (evento Gera o evento MouseLeave .


Args)

Ao mover o mouse ( args de Gera o evento MouseMove .


evento do mouse ) (Herdado de Control )

Ao mover o mouse para cima Gera o evento MouseUp .


( args de evento do mouse ) (Herdado de Control )

Na roda do mouse ( args de Gera o evento MouseWheel .


evento do mouse ) (Herdado de Control )

Em movimento ( args do Gera o evento Move .


evento) (Herdado de Control )

No clique do mouse no nó ( Gera o evento NodeMouseClick .


args do evento de clique do
mouse no nó da árvore )

Clique duplo no mouse do nó Gera o evento NodeMouseDoubleClick .


( args do evento de clique do
mouse no nó da árvore )

Ao passar o mouse sobre o Gera o evento NodeMouseHover .


nó ( Args do evento de mouse
sobre o nó da árvore )

Na mensagem de notificação Notifica o controle de mensagens do Windows.


(mensagem) (Herdado de Control )

No Padding Alterado (Event Gera o evento PaddingChanged .


Args) (Herdado de Control )

OnPaint(PaintEventArgs) Raises the Paint event.


(Inherited from Control)

OnPaintBackground(Paint Paints the background of the control.


EventArgs) (Inherited from Control)

OnParentBackColor Raises the BackColorChanged event when the BackColor


Changed(EventArgs) property value of the control's container changes.
(Inherited from Control)

OnParentBackgroundImage Raises the BackgroundImageChanged event when the


Changed(EventArgs) BackgroundImage property value of the control's container
changes.
(Inherited from Control)

No contexto de vinculação pai Gera o evento BindingContextChanged quando o valor da


alterado ( Args do evento) propriedade BindingContext do contêiner do controle é
alterado.

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 )

No pai alterado ( Args do Gera o evento ParentChanged .


evento) (Herdado de Control )

Cursor no pai alterado ( Args Gera o evento CursorChanged .


do evento) (Herdado de Control )

No contexto de dados pai (Herdado de Control )


alterado ( Args do evento)

On Parent Enabled Gera o evento EnabledChanged quando o valor da propriedade


Changed(Event Args) Enabled do contêiner do controle é alterado.
(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 )

Na cor principal principal Gera o evento ForeColorChanged quando o valor da


alterada ( Args do evento) propriedade ForeColor do contêiner do controle é alterado.
(Herdado de Control )

On Parent Right To Left Gera o evento RightToLeftChanged quando o valor da


Alterado (Event Args) propriedade RightToLeft do contêiner do controle é alterado.
(Herdado de Control )

On Parent Visible Gera o evento VisibleChanged quando o valor da propriedade


Changed(Event Args) Visible do contêiner do controle é alterado.
(Herdado de Control )

On Preview Key Down ( Args Gera o evento PreviewKeyDown .


do evento Preview Key Down (Herdado de Control )
)

Ao imprimir ( argumentos do Gera o evento Paint .


evento de pintura) (Herdado de Control )

On Query Continue Drag Gera o evento QueryContinueDrag .


(Query Continue Drag Event (Herdado de Control )
Args)

Na região alterada ( Args do Gera o evento RegionChanged .


evento) (Herdado de Control )

Ao redimensionar ( args do Gera o evento Resize .


evento) (Herdado de Control )

À direita para a esquerda Gera o evento RightToLeftChanged .


alterado ( Args do evento) (Herdado de Control )

No layout da direita para a Gera o evento RightToLeftLayoutChanged .

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

esquerda alterado ( Args do


evento)

Ao alterar o tamanho ( Gera o evento SizeChanged .


argumentos do evento) (Herdado de Control )

No estilo alterado ( Gera o evento StyleChanged .


argumentos do evento) (Herdado de Control )

Quando as cores do sistema Gera o evento SystemColorsChanged .


foram alteradas ( Args do (Herdado de Control )
evento)

Índice da guia alterado ( Args Gera o evento TabIndexChanged .


do evento) (Herdado de Control )

Parada na tabulação alterada ( Gera o evento TabStopChanged .


Args do evento) (Herdado de Control )

No texto alterado ( Args do Gera o evento TextChanged .


evento) (Herdado de Control )

Em Validado (Event Args) Gera o evento Validated .


(Herdado de Control )

Ao validar (cancelar Gera o evento Validating .


argumentos do evento ) (Herdado de Control )

On Visible Changed(Event Gera o evento VisibleChanged .


Args) (Herdado de Control )

Executar Layout() Força o controle a aplicar lógica de layout a todos os seus


controles filhos.
(Herdado de Control )

Executar Layout(Controle, Força o controle a aplicar lógica de layout a todos os seus


String) controles filhos.
(Herdado de Control )

Apontar para o cliente Calcula a localização do ponto de tela especificado nas


(apontar) coordenadas do cliente.
(Herdado de Control )

Apontar para a tela (apontar) Calcula a localização do ponto do cliente especificado nas
coordenadas da tela.
(Herdado de Control )

Mensagem de controle de Pré-processa o teclado ou as mensagens de entrada dentro do


pré- processo (mensagem) loop de mensagem antes de serem despachadas.
(Herdado de Control )

Mensagem de pré- Pré-processa o teclado ou as mensagens de entrada dentro do

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

processamento (mensagem) loop de mensagem antes de serem despachadas.


(Herdado de Control )

Chave de comando do Processa uma chave de comando.


processo (mensagem, chaves) (Herdado de Control )

Caixa de Diálogo do Processo Processa um caractere de diálogo.


Char(Char) (Herdado de Control )

Tecla de Diálogo do Processo Processa uma tecla de diálogo.


(Teclas) (Herdado de Control )

Args de evento chave do Processa uma mensagem-chave e gera os eventos de controle


processo (mensagem) apropriados.
(Herdado de Control )

Mensagem da Chave do Processa uma mensagem do teclado.


Processo (Mensagem) (Herdado de Control )

Visualização da chave do Visualiza uma mensagem do teclado.


processo (mensagem) (Herdado de Control )

Processo Mnemônico (Char) Processa um caractere mnemônico.


(Herdado de Control )

Aumentar evento de arrastar Gera o evento de arrastar apropriado.


(objeto, argumentos de (Herdado de Control )
evento de arrastar )

Levantar evento -chave Gera o evento de chave apropriado.


(objeto, argumentos do (Herdado de Control )
evento- chave )

Aumentar evento do mouse Gera o evento de mouse apropriado.


(objeto, argumentos do (Herdado de Control )
evento do mouse )

Aumentar evento de pintura Gera o evento de pintura apropriado.


(objeto, argumentos do (Herdado de Control )
evento de pintura )

Recriar identificador () Força a recriação do identificador para o controle.


(Herdado de Control )

Rectangle ToClient(Rectangle) Calcula o tamanho e a localização do retângulo de tela


especificado nas coordenadas do cliente.
(Herdado de Control )

Rectangle Calcula o tamanho e a localização do retângulo do cliente


ToScreen(Rectangle) especificado nas coordenadas da tela.
(Herdado de Control )

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

Atualizar() Força o controle a invalidar sua área de cliente e redesenhar


imediatamente a si mesmo e a qualquer controle filho.
(Herdado de Control )

Constantes de Fornece constantes para redimensionar o controle quando


redimensionamento para ocorre uma alteração de DPI.
Dpi(Int32, Int32) (Herdado de Control )

Redefinir cor traseira () Redefine a propriedade BackColor para seu valor padrão.
(Herdado de Control )

Redefinir Ligações () Faz com que um controle associado ao BindingSource releia


todos os itens da lista e atualize seus valores exibidos.
(Herdado de Control )

Reiniciar Cursor() Redefine a propriedade Cursor para seu valor padrão.


(Herdado de Control )

Redefinir fonte() Redefine a propriedade Font 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 )

Reiniciar Evento do Mouse Redefine o controle para manipular o evento MouseLeave .


Args() (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 )

Retomar Layout() Retoma a lógica de layout usual.


(Herdado de Control )

Layout do Currículo Retoma a lógica de layout usual, opcionalmente forçando um


(Booleano) layout imediato de solicitações de layout pendentes.
(Herdado de Control )

Rtl Translate Alinhamento ( Converte o ContentAlignment especificado no


Alinhamento de Conteúdo) ContentAlignment apropriado para dar suporte ao texto da
direita para a esquerda.
(Herdado de Control )

Rtl Translate Alinhamento ( Converte o HorizontalAlignment especificado no


Alinhamento Horizontal) HorizontalAlignment apropriado para dar suporte ao texto da
direita para a esquerda.
(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

Alinhamento de conversão Converte o LeftRightAlignment especificado no


RTL (alinhamento à esquerda LeftRightAlignment apropriado para dar suporte ao texto da
e à direita ) direita para a esquerda.
(Herdado de Control )

Rtl Translate Content ( Converte o ContentAlignment especificado no


Alinhamento de Conteúdo) ContentAlignment apropriado para dar suporte ao texto da
direita para a esquerda.
(Herdado de Control )

Rtl Translate Horizontal ( Converte o HorizontalAlignment especificado no


alinhamento horizontal) HorizontalAlignment apropriado para dar suporte ao texto da
direita para a esquerda.
(Herdado de Control )

Traduzir RTL Esquerda Direita Converte o LeftRightAlignment especificado no


(Alinhamento Esquerda LeftRightAlignment apropriado para dar suporte ao texto da
Direita ) direita para a esquerda.
(Herdado de Control )

Escala (Única) Obsoleto.


Dimensiona o controle e quaisquer controles filho.
(Herdado de Control )

Escala(Único, Único) Obsoleto.


Dimensiona todo o controle e quaisquer controles filho.
(Herdado de Control )

Escala(TamanhoF) Dimensiona o controle e todos os controles filho pelo fator de


dimensionamento especificado.
(Herdado de Control )

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 )

Controle de escala (tamanho Dimensiona a localização, tamanho, preenchimento e margem


F, limites especificados) de um controle.
(Herdado de Control )

Núcleo de escala (único, Este método não é relevante para esta classe.
único) (Herdado de Control )

Selecione() Ativa o controle.


(Herdado de Control )

Selecione (Booleano, Ativa um controle infantil. Opcionalmente, especifica a direção


Booleano) na ordem de tabulação para selecionar o controle.
(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

Selecione o próximo controle Ativa o próximo controle.


(controle, booleano, (Herdado de Control )
booleano, booleano,
booleano)

Enviar ToBack() Envia o controle para trás da ordem z.


(Herdado de Control )

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 )

Definir tamanho do cliente Define o tamanho da área do cliente do controle.


Núcleo (Int32, Int32) (Herdado de Control )

Definir estilo ( estilos de Define um sinalizador ControlStyles especificado como true ou


controle, booleano) false .
(Herdado de Control )

Definir nível superior Define o controle como o controle de nível superior.


(booleano) (Herdado de Control )

Definir Núcleo Visível Define o controle para o estado visível especificado.


(Booleano) (Herdado de Control )

Mostrar() Exibe o controle para o usuário.


(Herdado de Control )

Tamanho do tamanho do Determina o tamanho de todo o controle a partir da altura e


cliente (tamanho) largura de sua área cliente.
(Herdado de Control )

Organizar() Classifica os itens no controle TreeView .

Suspender Layout() Suspende temporariamente a lógica de layout do controle.


(Herdado de Control )

Para Cadeia () Retorna uma String contendo o nome do Componente , se


houver. Este método não deve ser substituído.

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

Atualizar() Faz com que o controle redesenhe as regiões invalidadas dentro


de sua área cliente.
(Herdado de Control )

Atualizar limites () Atualiza os limites do controle com o tamanho e localização


atuais.
(Herdado de Control )

Limites de atualização (Int32, Atualiza os limites do controle com o tamanho e localização


Int32, Int32, Int32) especificados.
(Herdado de Control )

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 )

Atualizar Estilos() Força os estilos atribuídos a serem reaplicados ao controle.


(Herdado de Control )

Atualizar ZOrder() Atualiza o controle na ordem z de seu pai.


(Herdado de Control )

Wnd Proc(Mensagem) Substitui WndProc(Mensagem) .

Eventos
Depois da Verificação Ocorre depois que a caixa de seleção do nó da árvore é
marcada.

Após o colapso Ocorre depois que o nó da árvore é recolhido.

Depois de Expandir Ocorre depois que o nó da árvore é expandido.

Após a edição do rótulo Ocorre depois que o texto do rótulo do nó da árvore é editado.

Depois de selecionar Ocorre depois que o nó da árvore é selecionado.

Tamanho automático alterado Este evento não é relevante para esta classe.
(Herdado de Control )

Cor do verso alterada Ocorre quando o valor da propriedade BackColor é alterado.


(Herdado de Control )

Imagem de fundo alterada Ocorre quando a propriedade BackgroundImage é alterada.

Layout da imagem de plano Ocorre quando a propriedade BackgroundImageLayout é


de fundo alterado alterada.

antes de verificar Ocorre antes que a caixa de seleção do nó da árvore seja


marcada.

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 do colapso Ocorre antes que o nó da árvore seja recolhido.

Antes de Expandir Ocorre antes que o nó da árvore seja expandido.

Antes da Edição do Rótulo Ocorre antes que o texto do rótulo do nó da árvore seja editado.

Antes de Selecionar Ocorre antes que o nó da árvore seja selecionado.

Contexto de vinculação Ocorre quando o valor da propriedade BindingContext é


alterado alterado.
(Herdado de Control )

Validação de Causas Alterada Ocorre quando o valor da propriedade CausesValidation é


alterado.
(Herdado de Control )

Alterar UICues Ocorre quando o foco ou as dicas da interface do usuário (IU)


do teclado são alteradas.
(Herdado de Control )

Clique Ocorre quando o controle é clicado.


(Herdado de Control )

Tamanho do cliente alterado Ocorre quando o valor da propriedade ClientSize é alterado.


(Herdado de Control )

Menu de Contexto Alterado Ocorre quando o valor da propriedade ContextMenu é alterado.


(Herdado de Control )

Faixa do Menu de Contexto Ocorre quando o valor da propriedade ContextMenuStrip é


Alterada alterado.
(Herdado de Control )

Controle Adicionado Ocorre quando um novo controle é adicionado ao


Control.ControlCollection .
(Herdado de Control )

Controle Removido Ocorre quando um controle é removido do


Control.ControlCollection .
(Herdado de Control )

Cursor alterado Ocorre quando o valor da propriedade Cursor é alterado.


(Herdado de Control )

Contexto de dados alterado Ocorre quando o valor da propriedade DataContext é alterado.


(Herdado de Control )

Descartado Ocorre quando o componente é descartado por uma chamada


ao método Dispose() .
(Herdado de Componente )

Doca alterada Ocorre quando o valor da propriedade Dock é alterado.

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 )

Clique duplo Ocorre quando o controle é clicado duas vezes.


(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 Soltar Ocorre quando uma operação de arrastar e soltar é concluída.


(Herdado de Control )

Arraste Enter Ocorre quando um objeto é arrastado para os limites do


controle.
(Herdado de Control )

Arrastar Sair Ocorre quando um objeto é arrastado para fora dos limites do
controle.
(Herdado de Control )

Arraste _ Ocorre quando um objeto é arrastado sobre os limites do


controle.
(Herdado de Control )

Desenhar Nó Ocorre quando um TreeView é desenhado e a propriedade


DrawMode é definida como um valor TreeViewDrawMode
diferente de Normal .

Habilitado Alterado Ocorre quando o valor da propriedade Enabled é alterado.


(Herdado de Control )

Digitar Ocorre quando o controle é inserido.


(Herdado de Control )

Fonte alterada Ocorre quando o valor da propriedade Font é alterado.


(Herdado de Control )

Cor da Frente Alterada Ocorre quando o valor da propriedade ForeColor é alterado.


(Herdado de Control )

Dar feedback Ocorre durante uma operação de arrastar.


(Herdado de Control )

Tenho Foco Ocorre quando o controle recebe o foco.


(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

Identificador criado Ocorre quando um identificador é criado para o controle.


(Herdado de Control )

Punho Destruído Ocorre quando o identificador do controle está sendo destruído.


(Herdado de Control )

Ajuda solicitada Ocorre quando o usuário solicita ajuda para um controle.


(Herdado de Control )

Modo Ime alterado Ocorre quando a propriedade ImeMode é alterada.


(Herdado de Control )

invalidado Ocorre quando a exibição de um controle requer redesenho.


(Herdado de Control )

Arrastar item Ocorre quando o usuário começa a arrastar um nó.

tecla para baixo Ocorre quando uma tecla é pressionada enquanto o controle
está em foco.
(Herdado de Control )

Pressione a tecla Ocorre quando um caractere. a tecla de espaço ou retrocesso é


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 )

Disposição Ocorre quando um controle deve reposicionar seus controles


filhos.
(Herdado de Control )

Deixar Ocorre quando o foco de entrada sai do controle.


(Herdado de Control )

Localização alterada Ocorre quando o valor da propriedade Location é alterado.


(Herdado de Control )

Perdeu o Foco Ocorre quando o controle perde o foco.


(Herdado de Control )

Margem alterada Ocorre quando a margem do controle é alterada.


(Herdado de Control )

Captura do mouse alterada Ocorre quando o controle perde a captura do mouse.


(Herdado de Control )

clique do mouse Ocorre quando o controle é clicado pelo mouse.


(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 Enter Ocorre quando o ponteiro do mouse entra no controle.


(Herdado de Control )

Passe o mouse Ocorre quando o ponteiro do mouse repousa sobre o controle.


(Herdado de Control )

Sair do Rato Ocorre quando o ponteiro do mouse sai do controle.


(Herdado de Control )

Movimento do mouse Ocorre quando o ponteiro do mouse é movido sobre o controle.


(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 )

Roda do mouse Ocorre quando a roda do mouse se move enquanto o controle


está em foco.
(Herdado de Control )

Mover Ocorre quando o controle é movido.


(Herdado de Control )

Nó clique do mouse Ocorre quando o usuário clica em um TreeNode com o mouse.

Node Mouse Clique Duplo Ocorre quando o usuário clica duas vezes em um TreeNode com
o mouse.

Nó do Mouse Ocorre quando o mouse passa sobre um TreeNode .

Preenchimento alterado Ocorre quando o valor da propriedade Padding é alterado.

Pintar Ocorre quando o TreeView é desenhado.

Parente alterado Ocorre quando o valor da propriedade Parent é alterado.


(Herdado de Control )

Preview Key Down Ocorre antes do evento KeyDown quando uma tecla é
pressionada enquanto o foco está neste controle.
(Herdado de Control )

Consultar Ajuda de Ocorre quando AccessibleObject está fornecendo ajuda para


Acessibilidade aplicativos de acessibilidade.
(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

deve ser cancelada.


(Herdado de Control )

Região alterada Ocorre quando o valor da propriedade Region é alterado.


(Herdado de Control )

Redimensionar Ocorre quando o controle é redimensionado.


(Herdado de Control )

Direita Para Esquerda Ocorre quando o valor da propriedade RightToLeft é alterado.


Alterado (Herdado de Control )

Layout da direita para a Ocorre quando o valor da propriedade RightToLeftLayout é


esquerda alterado alterado.

Tamanho alterado Ocorre quando o valor da propriedade Size é alterado.


(Herdado de Control )

Estilo alterado Ocorre quando o estilo de controle é alterado.


(Herdado de Control )

Cores do sistema alteradas Ocorre quando as cores do sistema mudam.


(Herdado de Control )

Índice de Tabulação Alterado Ocorre quando o valor da propriedade TabIndex é alterado.


(Herdado de Control )

Parada de Tabulação Alterada Ocorre quando o valor da propriedade TabStop é alterado.


(Herdado de Control )

Texto alterado Ocorre quando a propriedade Text é alterada.

Validado Ocorre quando o controle termina de validar.


(Herdado de Control )

Validando Ocorre quando o controle está validando.


(Herdado de Control )

Visível Alterado Ocorre quando o valor da propriedade Visível é alterado.


(Herdado de Control )

Implementações de Interface Explícita


Alvo Idrop . Ao arrastar e Gera o evento DragDrop .
soltar ( Args do evento de (Herdado de Control )
arrastar )

Alvo Idrop . Ao arrastar Enter Gera o evento DragEnter .


(arrastar argumentos do (Herdado de Control )
evento )

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

Alvo Idrop . Ao arrastar sair ( Gera o evento DragLeave .


args do evento) (Herdado de Control )

Alvo Idrop . Ao arrastar Gera o evento DragOver .


(arrastar argumentos do (Herdado de Control )
evento )

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

Área de trabalho do 3.0, 3.1, 5, 6, 7, 8


Windows

Veja também
TreeNode

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.treeview?view=windowsdesktop-7.0 37/37

Você também pode gostar