Partager via


Événements du contrôle serveur Web TreeView

Mise à jour : novembre 2007

Le contrôle serveur Web TreeView fournit plusieurs événements que vous pouvez programmer. Cela vous permet d'exécuter vos routines personnalisées lorsqu'un événement se produit.

Événements

Les événements de contrôle TreeView sont déclenchés uniquement lorsqu'un utilisateur interagit avec le contrôle en effectuant des tâches telles que la sélection, l'expansion ou la réduction d'un nœud. Ils ne sont pas déclenchés si les méthodes de sélection, d'expansion ou de réduction sont appelées par programme. Par exemple, si vous appelez la méthode Expand, aucun événement ne sera déclenché.

Le tableau suivant décrit les événements pris en charge par le contrôle TreeView.

Événement

Description

TreeNodeCheckChanged

Se produit lorsqu'une case à cocher du contrôle TreeView change d'état entre des publications au serveur. Se produit une fois pour chaque objet TreeNode qui est modifié.

SelectedNodeChanged

Se produit lorsqu'un nœud est sélectionné dans le contrôle TreeView.

TreeNodeExpanded

Se produit lorsqu'un nœud est développé dans le contrôle TreeView.

TreeNodeCollapsed

Se produit lorsqu'un nœud est réduit dans le contrôle TreeView.

TreeNodePopulate

Se produit lorsqu'un nœud, dont la propriété PopulateOnDemand a la valeur true, est développé dans le contrôle TreeView.

TreeNodeDataBound

Se produit lorsqu'un élément de données est lié à un nœud dans le contrôle TreeView.

Exemple

Événement SelectedNodeChanged

L'exemple de code suivant explique comment gérer l'événement SelectedNodeChanged et accéder à la propriété SelectedNode qui a déclenché l'événement. Il définit le texte de MyLabel comme le texte de propriété ToolTip de l'objet 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;
}

Événements TreeNodeExpanded et TreeNodeCollapsed

L'exemple de code suivant explique comment gérer les événements TreeNodeCollapsed et TreeNodeExpanded et accéder à l'objet TreeNode qui a été réduit ou développé.

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

Événement TreeNodePopulate

L'exemple de code suivant explique comment gérer l'événement TreeNodePopulate et ajouter par programme un nouvel objet TreeNode à la collection ChildNodes du nœud qui a déclenché l'événement.

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

Voir aussi

Concepts

Remplissage des nœuds de l'arbre dans le contrôle serveur Web TreeView

Personnalisation de l'apparence du contrôle serveur Web TreeView

Sélection, navigation et cases à cocher dans le contrôle serveur Web TreeView

Liaison de données au contrôle serveur Web TreeView

Référence

Vue d'ensemble du contrôle serveur Web TreeView