Eventi del controllo server Web TreeView

Articolo
10/22/2014

Aggiornamento: novembre 2007

Il controllo server Web TreeView fornisce diversi eventi programmabili. In questo modo è possibile eseguire una routine personalizzata ogni volta che si verifica un evento.

Eventi

Gli eventi del controllo TreeView vengono generati solo quando l'utente esegue un'azione sul controllo, ad esempio una selezione oppure l'espansione o la compressione di un nodo. Se la chiamata ai metodi di selezione, espansione o compressione è eseguita a livello di codice, gli eventi non verranno generati. Se ad esempio si chiama il metodo Expand, non verrà generato alcun evento.

Nella tabella riportata di seguito vengono descritti gli eventi supportati dal controllo TreeView.

Evento	Descrizione
TreeNodeCheckChanged	Si verifica quando lo stato di una casella di controllo di TreeView cambia tra un invio al server e un altro. Si verifica una sola volta per ogni oggetto TreeNode che cambia.
SelectedNodeChanged	Si verifica quando si seleziona un nodo nel controllo TreeView.
TreeNodeExpanded	Si verifica quando si espande un nodo nel controllo TreeView.
TreeNodeCollapsed	Si verifica quando si comprime un nodo nel controllo TreeView.
TreeNodePopulate	Si verifica quando si espande un nodo la cui proprietà PopulateOnDemand è impostata su true nel controllo TreeView.
TreeNodeDataBound	Si verifica quando si associa un elemento dati a un nodo nel controllo TreeView.

Esempio

Evento SelectedNodeChanged

Nel seguente codice di esempio viene mostrato come gestire l'evento SelectedNodeChanged e accedere alla proprietà SelectedNode che lo genera. Il testo di MyLabel viene impostato come testo della proprietà ToolTip del nodo 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;
}

Eventi TreeNodeExpanded e TreeNodeCollapsed

Nel seguente codice di esempio viene mostrato come gestire gli eventi TreeNodeCollapsed e TreeNodeExpanded, nonché come accedere all'oggetto TreeNode compresso o espanso.

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.";
}

Evento TreeNodePopulate

Nel seguente codice di esempio viene mostrato come gestire l'evento TreeNodePopulate e aggiungere a livello di codice un nuovo oggetto TreeNode all'insieme ChildNodes del nodo che ha generato l'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"));
}