Lire en anglais

Partager via


NodeLabelEditEventArgs Classe

Définition

Fournit des données pour les événements BeforeLabelEdit et AfterLabelEdit.

public class NodeLabelEditEventArgs : EventArgs
Héritage
NodeLabelEditEventArgs

Exemples

L’exemple suivant permet à l’utilisateur de modifier des nœuds d’arborescence non racines à l’aide d’un ContextMenu. Lorsque l’utilisateur clique avec le bouton droit sur la souris, le TreeNode à cette position est déterminé et stocké dans une variable nommée mySelectedNode. Si un nœud d’arborescence non racine a été sélectionné, il est placé dans un état modifiable, ce qui permet à l’utilisateur de modifier l’étiquette du nœud. Une fois que l’utilisateur a cessé de modifier l’étiquette du nœud d’arborescence, le nouveau texte d’étiquette est évalué et enregistré. Pour cet exemple, plusieurs caractères sont considérés comme non valides dans le texte de l’étiquette. Si l’un des caractères non valides se trouve dans la chaîne d’étiquette ou si la chaîne est vide, l’utilisateur est averti de l’erreur et l’étiquette est retournée à son texte précédent.

/* Get the tree node under the mouse pointer and
   save it in the mySelectedNode variable. */
private void treeView1_MouseDown(object sender,
  System.Windows.Forms.MouseEventArgs e)
{
   mySelectedNode = treeView1.GetNodeAt(e.X, e.Y);
}

private void menuItem1_Click(object sender, System.EventArgs e)
{
   if (mySelectedNode != null && mySelectedNode.Parent != null)
   {
      treeView1.SelectedNode = mySelectedNode;
      treeView1.LabelEdit = true;
      if(!mySelectedNode.IsEditing)
      {
         mySelectedNode.BeginEdit();
      }
   }
   else
   {
      MessageBox.Show("No tree node selected or selected node is a root node.\n" +
         "Editing of root nodes is not allowed.", "Invalid selection");
   }
}

private void treeView1_AfterLabelEdit(object sender,
         System.Windows.Forms.NodeLabelEditEventArgs e)
{
   if (e.Label != null)
   {
     if(e.Label.Length > 0)
     {
        if (e.Label.IndexOfAny(new char[]{'@', '.', ',', '!'}) == -1)
        {
           // Stop editing without canceling the label change.
           e.Node.EndEdit(false);
        }
        else
        {
           /* Cancel the label edit action, inform the user, and
              place the node in edit mode again. */
           e.CancelEdit = true;
           MessageBox.Show("Invalid tree node label.\n" +
              "The invalid characters are: '@','.', ',', '!'",
              "Node Label Edit");
           e.Node.BeginEdit();
        }
     }
     else
     {
        /* Cancel the label edit action, inform the user, and
           place the node in edit mode again. */
        e.CancelEdit = true;
        MessageBox.Show("Invalid tree node label.\nThe label cannot be blank",
           "Node Label Edit");
        e.Node.BeginEdit();
     }
   }
}

Remarques

L’événement AfterLabelEdit se produit lorsque l’utilisateur a terminé de modifier le texte d’un nœud d’arborescence. L’événement BeforeLabelEdit se produit lorsque l’utilisateur commence à modifier le texte d’un nœud d’arborescence. Un NodeLabelEditEventArgs objet spécifie le nouveau texte à associer au nœud d’arborescence, le nœud d’arborescence qui contient l’étiquette à modifier et si l’opération de modification a été annulée.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

Constructeurs

NodeLabelEditEventArgs(TreeNode)

Initialise une nouvelle instance de la classe NodeLabelEditEventArgs pour le TreeNode spécifié.

NodeLabelEditEventArgs(TreeNode, String)

Initialise une nouvelle instance de la classe NodeLabelEditEventArgs pour le TreeNode spécifié et le texte spécifié utilisé pour mettre à jour l'étiquette du nœud d'arbre.

Propriétés

CancelEdit

Obtient ou définit une valeur indiquant si la modification a été annulée.

Label

Obtient le nouveau texte à associer au nœud d’arbre.

Node

Obtient le nœud d’arbre contenant le texte à modifier.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Produit Versions
.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
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Voir aussi