TreeNode.Text Propriété

Définition

Obtient ou définit le texte affiché dans l'étiquette du nœud d'arbre.

C#
public string Text { get; set; }

Valeur de propriété

String

Le texte affiché dans l'étiquette du nœud d'arbre.

Exemples

L’exemple de code suivant crée un nœud d’arborescence racine pour affecter des nœuds d’arborescence enfants. Un nœud d’arborescence enfant pour chaque Customer objet d’un ArrayList objet est ajouté au nœud d’arborescence racine, ainsi qu’un nœud d’arborescence enfant pour chaque Order objet affecté à l’objet Customer . L’objet Customer est affecté à la Tag propriété et les nœuds d’arborescence représentant Customer des objets sont affichés avec Orange du texte. Cet exemple nécessite que vous ayez défini TreeView un objet et Order un Customer contrôle sur un Formet un ArrayList nom customerArray qui contient des Customer objets.

C#
public class Customer
{
   public ArrayList CustomerOrders;
   public string CustomerName;
   public Customer(string myName)
   {
      CustomerName = myName;
      CustomerOrders = new ArrayList(); 
   }
}
public class Order
{
   public string OrderID;
   public Order(string myOrderID )
   {
      this.OrderID = myOrderID;
   }
}

public void AddRootNodes()
{
   // Add a root node to assign the customer nodes to.
   TreeNode rootNode = new TreeNode();
   rootNode.Text = "CustomerList";
   // Add a main root treenode.
   myTreeView.Nodes.Add(rootNode);

   // Add a root treenode for each 'Customer' object in the ArrayList.
   foreach(Customer myCustomer in customerArray)
   {
      // Add a child treenode for each Order object.
      int i = 0;
      TreeNode[] myTreeNodeArray = new TreeNode[5];
      foreach(Order myOrder in myCustomer.CustomerOrders)
      {
         myTreeNodeArray[i] = new TreeNode(myOrder.OrderID);
         i++;
      }
      TreeNode customerNode = new TreeNode(myCustomer.CustomerName,
        myTreeNodeArray);
        // Display the customer names with and Orange font.
        customerNode.ForeColor = Color.Orange;
        // Store the Customer object in the Tag property of the TreeNode.
        customerNode.Tag = myCustomer;
      myTreeView.Nodes[0].Nodes.Add(customerNode);
   }
}

Remarques

Le nombre maximal de caractères qu’un TreeNode peut afficher est de 259. Si une String valeur de plus de 259 caractères est affectée à cette propriété, seuls les 259 premiers caractères sont affichés.

Cette propriété ne peut pas être définie par l’utilisateur si la LabelEdit propriété du parent TreeView est définie falsesur . L’alternative à la définition explicite de cette propriété consiste à créer le nœud d’arbre à l’aide de l’un TreeNode des constructeurs qui a un paramètre de chaîne qui représente la Text propriété. L’étiquette s’affiche en regard de l’image TreeNode , si elle est affichée.

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
Windows Desktop 3.0, 3.1, 5, 6, 7

Voir aussi