TreeNode Oluşturucular

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

TreeNode sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

TreeNode()	TreeNode sınıfının yeni bir örneğini başlatır.
TreeNode(String)	Belirtilen etiket metniyle sınıfının yeni bir örneğini TreeNode başlatır.
TreeNode(SerializationInfo, StreamingContext)	Belirtilen serileştirme bilgilerini ve bağlamını TreeNode kullanarak sınıfının yeni bir örneğini başlatır.
TreeNode(String, TreeNode[])	Belirtilen etiket metni ve alt ağaç düğümleriyle sınıfının yeni bir örneğini TreeNode başlatır.
TreeNode(String, Int32, Int32)	Ağaç düğümü seçili ve seçilmemiş durumdayken görüntülenecek belirtilen etiket metni ve görüntüleriyle sınıfın yeni bir örneğini TreeNode başlatır.
TreeNode(String, Int32, Int32, TreeNode[])	Belirtilen etiket metni, alt ağaç düğümleri ve görüntülerle sınıfın TreeNode yeni bir örneğini başlatır ve ağaç düğümü seçili ve seçilmemiş durumda olduğunda görüntülenecektir.

TreeNode()

TreeNode sınıfının yeni bir örneğini başlatır.

C#

public TreeNode ();

Örnekler

Aşağıdaki kod örneği, alt ağaç düğümlerini atamak için bir kök ağaç düğümü oluşturur. kök ağaç düğümüne bir ArrayList alt ağaç düğümü Customer ve nesneye atanan Customer her Order nesne için bir alt ağaç düğümü eklenir. Customer nesnesi özelliğine Tag atanır ve nesneleri temsil eden Customer ağaç düğümleri metinle Orange birlikte görüntülenir. Bu örnekte tanımlı bir Customer ve Order nesnesine, üzerinde bir TreeView Formdenetime ve nesneleri içeren Customer bir ArrayList adlandırılmış customerArray öğeye sahip olmanız gerekir.

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

Ayrıca bkz.

• TreeView
• TreeNodeCollection

TreeNode(String)

Belirtilen etiket metniyle sınıfının yeni bir örneğini TreeNode başlatır.

C#

public TreeNode (string text);

Parametreler

text

String

Yeni ağaç düğümünün etiketi Text .

Örnekler

Aşağıdaki kod örneği bir TreeView denetimde müşteri bilgilerini görüntüler. Kök ağaç düğümleri müşteri adlarını, alt ağaç düğümleri ise her müşteriye atanan sipariş numaralarını görüntüler. Bu örnekte, her birinde 15 sipariş olan 1.000 müşteri görüntülenir. ve yöntemleri kullanılarak BeginUpdate EndUpdate öğesinin yeniden boyanmış TreeView olması bastırılır ve nesneler oluşturulurken ve boyanırken TreeNode TreeView bir bekleme Cursor görüntülenir. Bu örnek, bir Customer nesne koleksiyonunu Order barındırabilen bir nesneniz olmasını gerektirir. Ayrıca üzerinde bir TreeView denetimin Formörneğini oluşturmuş olmanız gerekir.

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

Açıklamalar

text Parametre değeri düğümün Text özelliğine atanır ve ağaç düğümü etiketi olur.

Ayrıca bkz.

• TreeView
• TreeNodeCollection

TreeNode(SerializationInfo, StreamingContext)

Belirtilen serileştirme bilgilerini ve bağlamını TreeNode kullanarak sınıfının yeni bir örneğini başlatır.

C#

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

Parametreler

serializationInfo

SerializationInfo

sınıfı SerializationInfo seri durumdan çıkarma verilerini içeren.

context

StreamingContext

Seri StreamingContext hale getirilmiş akışın kaynağını ve hedefini içeren.

TreeNode(String, TreeNode[])

Belirtilen etiket metni ve alt ağaç düğümleriyle sınıfının yeni bir örneğini TreeNode başlatır.

C#

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

Parametreler

text

String

Yeni ağaç düğümünün etiketi Text .

children

TreeNode[]

Bir alt TreeNode nesne dizisi.

Örnekler

Aşağıdaki kod örneği, alt ağaç düğümlerini atamak için bir kök ağaç düğümü oluşturur. kök ağaç düğümüne bir ArrayList alt ağaç düğümü Customer ve nesneye atanan Customer her Order nesne için bir alt ağaç düğümü eklenir. Customer nesnesi özelliğine Tag atanır ve nesneleri temsil eden Customer ağaç düğümleri metinle Orange birlikte görüntülenir. Bu örnekte tanımlı bir Customer ve Order nesnesine, üzerinde bir TreeView Formdenetime ve nesneleri içeren Customer bir ArrayList adlandırılmış customerArray öğeye sahip olmanız gerekir.

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

Açıklamalar

text Parametre değeri düğümün Text özelliğine atanır ve ağaç düğümü etiketi olur. Dizide children yer alan ağaç düğümleri özelliğinde Nodes depolanan öğesine TreeNodeCollection eklenir.

Ayrıca bkz.

• TreeView
• TreeNodeCollection

TreeNode(String, Int32, Int32)

Ağaç düğümü seçili ve seçilmemiş durumdayken görüntülenecek belirtilen etiket metni ve görüntüleriyle sınıfın yeni bir örneğini TreeNode başlatır.

C#

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

Parametreler

text

String

Yeni ağaç düğümünün etiketi Text .

imageIndex

Int32

Ağaç düğümü seçilmediğinde görüntülenecek dizin değeri Image .

selectedImageIndex

Int32

Ağaç düğümü seçildiğinde görüntülenecek dizin değeri Image .

Örnekler

Aşağıdaki kod örneği bir ImageList TreeView denetim oluşturup bir denetime atar ve denetimi nesnelerle TreeNode doldururTreeView. Ağaç düğümlerine, ağaç düğümü seçili veya seçilmemiş durumdayken görüntülenen öğesinden ImageList görüntüler atanır. Bu örnek, içeren bir Form TreeViewve her Order nesne içeren nesneleri içeren Customer bir ArrayList sahip olmasını gerektirir. Ayrıca ve Order nesnelerinin Customer tanımlanmasını da gerektirir.

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

Açıklamalar

text Parametre değeri düğümün Text özelliğine atanır ve ağaç düğümü etiketi olur. imageIndex ve selectedImageIndex değerleri, özelliğine atanan içinde ImageList depolanan bir Image dizinin dizin değerleridirTreeView.ImageList. Ağaç düğümü seçilmediğinde özelliğinde imageIndex başvurulan görüntü görüntülenir. Benzer şekilde, ağaç düğümü seçili durumdayken özelliğinde başvurulan selectedImageIndex görüntü görüntülenir.

Ayrıca bkz.

• TreeView
• TreeNodeCollection

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

Belirtilen etiket metni, alt ağaç düğümleri ve görüntülerle sınıfın TreeNode yeni bir örneğini başlatır ve ağaç düğümü seçili ve seçilmemiş durumda olduğunda görüntülenecektir.

C#

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

Parametreler

text

String

Yeni ağaç düğümünün etiketi Text .

imageIndex

Int32

Ağaç düğümü seçilmediğinde görüntülenecek dizin değeri Image .

selectedImageIndex

Int32

Ağaç düğümü seçildiğinde görüntülenecek dizin değeri Image .

children

TreeNode[]

Bir alt TreeNode nesne dizisi.

Örnekler

Aşağıdaki kod örneği bir ImageList TreeView denetim oluşturup bir denetime atar ve denetimi nesnelerle TreeNode doldururTreeView. Ağaç düğümlerine, ağaç düğümü seçili veya seçilmemiş durumdayken görüntülenen öğesinden ImageList görüntüler atanır. Bu örnek, içeren bir Form TreeViewve her Order nesne içeren nesneleri içeren Customer bir ArrayList sahip olmasını gerektirir. Ayrıca ve Order nesnelerinin Customer tanımlanmasını da gerektirir.

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

Açıklamalar

text Parametre değeri düğümün Text özelliğine atanır ve ağaç düğümü etiketi olur. imageIndex ve selectedImageIndex değerleri, özelliğine atanan içinde ImageList depolanan bir Image dizinin dizin değerleridirTreeView.ImageList. Parametrede imageIndex başvurulan görüntü, ağaç düğümü seçilmediğinde görüntülenir. Benzer şekilde, ağaç düğümü seçili durumdayken parametrede başvurulan selectedImageIndex görüntü görüntülenir. Dizide children yer alan ağaç düğümleri özelliğinde Nodes depolanan öğesine TreeNodeCollection eklenir.

Ayrıca bkz.

• TreeView
• TreeNodeCollection