Compartilhar via


Eventos do Controle TreeView do Servidor Web

O controle TreeView de servidor Web fornece vários eventos que você pode programar.Isso permite que você execute suas rotinas personalizadas sempre que ocorre um evento.

Eventos

Eventos de controle TreeView são gerados apenas quando um usuário interage com o controle seguindo itens como selecionar, expandindo ou recolhendo um nó.Eles não são gerados se os métodos selecionar, expandir, ou recolher são chamados por meio de programação.Por exemplo, se você chamar o método Expand, nenhum evento será gerado.

A tabela a seguir descreve os eventos que são suportados pelo controle TreeView.

Evento

Descrição

TreeNodeCheckChanged

Ocorre quando um caixa de seleção do controle TreeView altera o estado entre as postagens para o servidor.Ocorre uma vez para cada objeto TreeNode que muda.

SelectedNodeChanged

Ocorre quando um nó é selecionado no controle TreeView.

TreeNodeExpanded

Ocorre quando um nó é expandido no controle TreeView.

TreeNodeCollapsed

Ocorre quando um nó é fechado no controle TreeView.

TreeNodePopulate

Ocorre quando um nó, com sua propriedade PopulateOnDemand definida como true é expandida no controle TreeView.

TreeNodeDataBound

Ocorre quando um item de dados é vinculado ao nó no controle TreeView.

Exemplo

O evento SelectedNodeChanged

O exemplo de código a seguir demonstra manipulação do evento SelectedNodeChanged e acesso a propriedade SelectedNode que dispara o evento.Ele define o texto de MyLabel para ser o texto da propriedade ToolTip de SelectedNode.

Protected Sub TreeView1_SelectedNodeChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles TreeView1.SelectedNodeChanged
    MyLabel.Text = TreeView1.SelectedNode.ToolTip

End Sub
protected void TreeView1_SelectedNodeChanged(object sender, EventArgs e)
{
    MyLabel.Text = TreeView1.SelectedNode.ToolTip;
}

Os eventos TreeNodeExpanded e TreeNodeCollapsed

O exemplo de código a seguir demonstra manipulção do evento TreeNodeCollapsed e do evento TreeNodeExpanded e, em seguida, acesso ao objeto TreeNode que foi recolhido ou expandido.

Protected Sub TreeView1_TreeNodeCollapsed(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodeCollapsed
    MyLabel.Text = "You collapsed the " & e.Node.Value & " node."
End Sub

Protected Sub TreeView1_TreeNodeExpanded(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodeExpanded
    MyLabel.Text = "You expanded the " & e.Node.Value & " node."
End Sub
protected void TreeView1_TreeNodeCollapsed(object sender, TreeNodeEventArgs e)
{
    MyLabel.Text = "You collapsed the " + e.Node.Value + " node.";
}
protected void TreeView1_TreeNodeExpanded(object sender, TreeNodeEventArgs e)
{
    MyLabel.Text = "You expanded the " + e.Node.Value + " node.";
}

O evento TreeNodePopulate

O exemplo de código a seguir demonstra manipulação do evento TreeNodePopulate e, em seguida, adição programaticamente de um novo objeto TreeNode à ChildNodes coleção do nó que dispara o evento.

Protected Sub TreeView1_TreeNodePopulate(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodePopulate
    e.Node.ChildNodes.Add(New TreeNode("New Node Populated on Demand"))
End Sub
protected void TreeView1_TreeNodePopulate(object sender, TreeNodeEventArgs e)
{
    e.Node.ChildNodes.Add(new TreeNode("New Node Populated on Demand"));
}

Consulte também

Conceitos

Preenchendo Nós de Árvore no Controle do Servidor Web TreeView

Personalizando a Aparência (Look and Feel) do Controle do Servidor Web TreeView

Seleção, Navegação, e Caixas de Seleção no Controle de Servidor Web TreeView

Ligando Dados ao Controle de Servidor Web TreeView

Referência

Visão geral do Controle do Servidor Web TreeView