TreeNode Constructeurs

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Initialise une nouvelle instance de la classe TreeNode.

Surcharges

TreeNode()	Initialise une nouvelle instance de la classe TreeNode.
TreeNode(String)	Initialise une nouvelle instance de la classe TreeNode avec le texte d'étiquette spécifié.
TreeNode(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe TreeNode à l'aide des informations de sérialisation et de contexte spécifiées.
TreeNode(String, TreeNode[])	Initialise une nouvelle instance de la classe TreeNode avec le texte d'étiquette spécifié et les nœuds d'arbre enfants.
TreeNode(String, Int32, Int32)	Initialise une nouvelle instance de la classe TreeNode avec le texte d'étiquette spécifié et les images à afficher quand le nœud d'arbre est dans l'état sélectionné et non sélectionné.
TreeNode(String, Int32, Int32, TreeNode[])	Initialise une nouvelle instance de la classe TreeNode avec le texte d'étiquette spécifié, les nœuds d'arbre enfants, et les images à afficher quand le nœud d'arbre est dans l'état sélectionné et non sélectionné.

TreeNode()

Initialise une nouvelle instance de la classe TreeNode.

C#

public TreeNode ();

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

Voir aussi

• TreeView
• TreeNodeCollection

TreeNode(String)

Initialise une nouvelle instance de la classe TreeNode avec le texte d'étiquette spécifié.

C#

public TreeNode (string text);

Paramètres

text

String

Text d'étiquette du nouveau nœud d'arbre.

Exemples

L’exemple de code suivant affiche les informations du client dans un TreeView contrôle. Les nœuds d’arborescence racine affichent les noms de clients et les nœuds d’arborescence enfants affichent les numéros de commande attribués à chaque client. Dans cet exemple, 1 000 clients sont affichés avec 15 commandes chacune. La peinture de l’objet TreeView est supprimée à l’aide BeginUpdate des méthodes et EndUpdate des méthodes, et une attente Cursor s’affiche pendant la TreeView création et la peinture des TreeNode objets. Cet exemple nécessite que vous ayez un Customer objet qui peut contenir une collection d’objets Order . Il nécessite également que vous ayez créé une instance d’un contrôle sur un TreeView Form.

C#

// The basic Customer class.
public class Customer : System.Object
{
   private string custName = "";
   protected ArrayList custOrders = new ArrayList();

   public Customer(string customername)
   {
      this.custName = customername;
   }

   public string CustomerName
   {      
      get{return this.custName;}
      set{this.custName = value;}
   }

   public ArrayList CustomerOrders 
   {
      get{return this.custOrders;}
   }
} // End Customer class 

// The basic customer Order class.
public class Order : System.Object
{
   private string ordID = "";

   public Order(string orderid)
   {
      this.ordID = orderid;
   }

   public string OrderID
   {      
      get{return this.ordID;}
      set{this.ordID = value;}
   }
} // End Order class

// Create a new ArrayList to hold the Customer objects.
private ArrayList customerArray = new ArrayList(); 

private void FillMyTreeView()
{
   // Add customers to the ArrayList of Customer objects.
   for(int x=0; x<1000; x++)
   {
      customerArray.Add(new Customer("Customer" + x.ToString()));
   }

   // Add orders to each Customer object in the ArrayList.
   foreach(Customer customer1 in customerArray)
   {
      for(int y=0; y<15; y++)
      {
         customer1.CustomerOrders.Add(new Order("Order" + y.ToString()));    
      }
   }

   // Display a wait cursor while the TreeNodes are being created.
   Cursor.Current = new Cursor("MyWait.cur");
        
   // Suppress repainting the TreeView until all the objects have been created.
   treeView1.BeginUpdate();

   // Clear the TreeView each time the method is called.
   treeView1.Nodes.Clear();

   // Add a root TreeNode for each Customer object in the ArrayList.
   foreach(Customer customer2 in customerArray)
   {
      treeView1.Nodes.Add(new TreeNode(customer2.CustomerName));
          
      // Add a child treenode for each Order object in the current Customer object.
      foreach(Order order1 in customer2.CustomerOrders)
      {
         treeView1.Nodes[customerArray.IndexOf(customer2)].Nodes.Add(
           new TreeNode(customer2.CustomerName + "." + order1.OrderID));
      }
   }

   // Reset the cursor to the default for all controls.
   Cursor.Current = Cursors.Default;

   // Begin repainting the TreeView.
   treeView1.EndUpdate();
}

Remarques

La text valeur du paramètre est affectée à la propriété du Text nœud et devient l’étiquette de nœud d’arborescence.

Voir aussi

• TreeView
• TreeNodeCollection

TreeNode(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe TreeNode à l'aide des informations de sérialisation et de contexte spécifiées.

C#

protected TreeNode (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext context);

Paramètres

serializationInfo

SerializationInfo

SerializationInfo qui contient les données permettant de désérialiser la classe.

context

StreamingContext

StreamingContext qui contient la source et la destination du flux sérialisé.

TreeNode(String, TreeNode[])

Initialise une nouvelle instance de la classe TreeNode avec le texte d'étiquette spécifié et les nœuds d'arbre enfants.

C#

public TreeNode (string text, System.Windows.Forms.TreeNode[] children);

Paramètres

text

String

Text d'étiquette du nouveau nœud d'arbre.

children

TreeNode[]

Tableau d'objets TreeNode enfants.

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

La text valeur du paramètre est affectée à la propriété du Text nœud et devient l’étiquette de nœud d’arborescence. Les nœuds d’arborescence contenus dans le children tableau sont ajoutés à celui TreeNodeCollection stocké dans la Nodes propriété.

Voir aussi

• TreeView
• TreeNodeCollection

TreeNode(String, Int32, Int32)

Initialise une nouvelle instance de la classe TreeNode avec le texte d'étiquette spécifié et les images à afficher quand le nœud d'arbre est dans l'état sélectionné et non sélectionné.

C#

public TreeNode (string text, int imageIndex, int selectedImageIndex);

Paramètres

text

String

Text d'étiquette du nouveau nœud d'arbre.

imageIndex

Int32

Valeur d'index du Image à afficher quand le nœud d'arbre est non sélectionné.

selectedImageIndex

Int32

Valeur d'index du Image à afficher quand le nœud d'arbre est sélectionné.

Exemples

L’exemple de code suivant crée et affecte un ImageList TreeView contrôle et remplit le TreeView contrôle avec TreeNode des objets. Les nœuds d’arborescence sont affectés aux images ImageList affichées lorsque le nœud d’arborescence se trouve dans un état sélectionné ou non sélectionné. Cet exemple nécessite que vous ayez un qui contient un Form TreeView, et un ArrayList qui contient Customer des objets qui contiennent chacun des Order objets. Il exige également que les objets et Order les Customer objets soient définis.

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

private void FillTreeView()
{
    // Load the images in an ImageList.
    ImageList myImageList = new ImageList();
    myImageList.Images.Add(Image.FromFile("Default.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedDefault.gif"));
    myImageList.Images.Add(Image.FromFile("Root.gif"));
    myImageList.Images.Add(Image.FromFile("UnselectedCustomer.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedCustomer.gif"));
    myImageList.Images.Add(Image.FromFile("UnselectedOrder.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedOrder.gif"));
    
    // Assign the ImageList to the TreeView.
    myTreeView.ImageList = myImageList;
    
    // Set the TreeView control's default image and selected image indexes.
    myTreeView.ImageIndex = 0;
    myTreeView.SelectedImageIndex = 1;

    /* Set the index of image from the 
    ImageList for selected and unselected tree nodes.*/
    this.rootImageIndex = 2;
    this.selectedCustomerImageIndex = 3;
    this.unselectedCustomerImageIndex = 4;
    this.selectedOrderImageIndex = 5;
    this.unselectedOrderImageIndex = 6;
    
    // Create the root tree node.
    TreeNode rootNode = new TreeNode("CustomerList");
    rootNode.ImageIndex = rootImageIndex;
    rootNode.SelectedImageIndex = rootImageIndex;
      
    // Add a main root tree node.
    myTreeView.Nodes.Add(rootNode);

    // Add a root tree node for each Customer object in the ArrayList.
    foreach(Customer myCustomer in customerArray)
    {
        // Add a child tree node for each Order object.
        int countIndex=0;
        TreeNode[] myTreeNodeArray = new TreeNode[myCustomer.CustomerOrders.Count];
        foreach(Order myOrder in myCustomer.CustomerOrders)
        {
            // Add the Order tree node to the array.
            myTreeNodeArray[countIndex] = new TreeNode(myOrder.OrderID,
              unselectedOrderImageIndex, selectedOrderImageIndex);
            countIndex++;
        }
        // Add the Customer tree node.
        TreeNode customerNode = new TreeNode(myCustomer.CustomerName,
            unselectedCustomerImageIndex, selectedCustomerImageIndex, myTreeNodeArray);
        myTreeView.Nodes[0].Nodes.Add(customerNode);
    }
}

Remarques

La text valeur du paramètre est affectée à la propriété du Text nœud et devient l’étiquette de nœud d’arborescence. Les imageIndex valeurs et selectedImageIndex valeurs sont les valeurs d’index d’un Image stocké dans la ImageList TreeView.ImageList propriété affectée. L’image référencée dans la imageIndex propriété s’affiche lorsque le nœud d’arborescence n’est pas sélectionné. De même, l’image référencée dans la selectedImageIndex propriété s’affiche lorsque le nœud d’arborescence est dans un état sélectionné.

Voir aussi

• TreeView
• TreeNodeCollection

TreeNode(String, Int32, Int32, TreeNode[])

Initialise une nouvelle instance de la classe TreeNode avec le texte d'étiquette spécifié, les nœuds d'arbre enfants, et les images à afficher quand le nœud d'arbre est dans l'état sélectionné et non sélectionné.

C#

public TreeNode (string text, int imageIndex, int selectedImageIndex, System.Windows.Forms.TreeNode[] children);

Paramètres

text

String

Text d'étiquette du nouveau nœud d'arbre.

imageIndex

Int32

Valeur d'index du Image à afficher quand le nœud d'arbre est non sélectionné.

selectedImageIndex

Int32

Valeur d'index du Image à afficher quand le nœud d'arbre est sélectionné.

children

TreeNode[]

Tableau d'objets TreeNode enfants.

Exemples

L’exemple de code suivant crée et affecte un ImageList TreeView contrôle et remplit le TreeView contrôle avec TreeNode des objets. Les nœuds d’arborescence sont affectés aux images ImageList affichées lorsque le nœud d’arborescence se trouve dans un état sélectionné ou non sélectionné. Cet exemple nécessite que vous ayez un qui contient un Form TreeView, et un ArrayList qui contient Customer des objets qui contiennent chacun des Order objets. Il exige également que les objets et Order les Customer objets soient définis.

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

private void FillTreeView()
{
    // Load the images in an ImageList.
    ImageList myImageList = new ImageList();
    myImageList.Images.Add(Image.FromFile("Default.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedDefault.gif"));
    myImageList.Images.Add(Image.FromFile("Root.gif"));
    myImageList.Images.Add(Image.FromFile("UnselectedCustomer.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedCustomer.gif"));
    myImageList.Images.Add(Image.FromFile("UnselectedOrder.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedOrder.gif"));
    
    // Assign the ImageList to the TreeView.
    myTreeView.ImageList = myImageList;
    
    // Set the TreeView control's default image and selected image indexes.
    myTreeView.ImageIndex = 0;
    myTreeView.SelectedImageIndex = 1;

    /* Set the index of image from the 
    ImageList for selected and unselected tree nodes.*/
    this.rootImageIndex = 2;
    this.selectedCustomerImageIndex = 3;
    this.unselectedCustomerImageIndex = 4;
    this.selectedOrderImageIndex = 5;
    this.unselectedOrderImageIndex = 6;
    
    // Create the root tree node.
    TreeNode rootNode = new TreeNode("CustomerList");
    rootNode.ImageIndex = rootImageIndex;
    rootNode.SelectedImageIndex = rootImageIndex;
      
    // Add a main root tree node.
    myTreeView.Nodes.Add(rootNode);

    // Add a root tree node for each Customer object in the ArrayList.
    foreach(Customer myCustomer in customerArray)
    {
        // Add a child tree node for each Order object.
        int countIndex=0;
        TreeNode[] myTreeNodeArray = new TreeNode[myCustomer.CustomerOrders.Count];
        foreach(Order myOrder in myCustomer.CustomerOrders)
        {
            // Add the Order tree node to the array.
            myTreeNodeArray[countIndex] = new TreeNode(myOrder.OrderID,
              unselectedOrderImageIndex, selectedOrderImageIndex);
            countIndex++;
        }
        // Add the Customer tree node.
        TreeNode customerNode = new TreeNode(myCustomer.CustomerName,
            unselectedCustomerImageIndex, selectedCustomerImageIndex, myTreeNodeArray);
        myTreeView.Nodes[0].Nodes.Add(customerNode);
    }
}

Remarques

La text valeur du paramètre est affectée à la propriété du Text nœud et devient l’étiquette de nœud d’arborescence. Les imageIndex valeurs et selectedImageIndex valeurs sont les valeurs d’index d’un Image stocké dans la ImageList TreeView.ImageList propriété affectée. L’image référencée dans le imageIndex paramètre s’affiche lorsque le nœud d’arborescence n’est pas sélectionné. De même, l’image référencée dans le selectedImageIndex paramètre s’affiche lorsque le nœud d’arborescence est dans un état sélectionné. Les nœuds d’arborescence contenus dans le children tableau sont ajoutés à celui TreeNodeCollection stocké dans la Nodes propriété.

Voir aussi

• TreeView
• TreeNodeCollection