TreeNode Třída

Definice

public ref class TreeNode : MarshalByRefObject, ICloneable, System::Runtime::Serialization::ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TreeNodeConverter))]
[System.Serializable]
public class TreeNode : MarshalByRefObject, ICloneable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TreeNodeConverter))>]
[<System.Serializable>]
type TreeNode = class
    inherit MarshalByRefObject
    interface ICloneable
    interface ISerializable

Public Class TreeNode
Inherits MarshalByRefObject
Implements ICloneable, ISerializable

Dědičnost

Object

MarshalByRefObject

TreeNode

Odvozené

System.ComponentModel.Design.ObjectSelectorEditor.SelectorNode

System.Workflow.ComponentModel.Design.WorkflowOutlineNode

Atributy

TypeConverterAttribute SerializableAttribute

Implementuje

ICloneable ISerializable

Příklady

Následující příklad kódu zobrazí informace o zákazníkovi v ovládacím TreeView prvku. Uzly kořenového stromu zobrazují jména zákazníků a uzly podřízeného stromu zobrazují čísla objednávek přiřazená každému zákazníkovi. V tomto příkladu se zobrazí 1 000 zákazníků s 15 objednávkami. Překreslení TreeNode objektu TreeView je potlačeno pomocí BeginUpdate metod a EndUpdate a při vytváření a malování objektů se zobrazí TreeView čekáníCursor. Tento příklad vyžaduje, abyste měli Customer objekt, který může obsahovat kolekci Order objektů. Vyžaduje také, abyste vytvořili instanci TreeView ovládacího prvku v objektu Form.

// The basic Customer class.
ref class Customer: public System::Object
{
private:
   String^ custName;

protected:
   ArrayList^ custOrders;

public:
   Customer( String^ customername )
   {
      custName = "";
      custOrders = gcnew ArrayList;
      this->custName = customername;
   }


   property String^ CustomerName 
   {
      String^ get()
      {
         return this->custName;
      }

      void set( String^ value )
      {
         this->custName = value;
      }

   }

   property ArrayList^ CustomerOrders 
   {
      ArrayList^ get()
      {
         return this->custOrders;
      }

   }

};


// End Customer class
// The basic customer Order class.
ref class Order: public System::Object
{
private:
   String^ ordID;

public:
   Order( String^ orderid )
   {
      ordID = "";
      this->ordID = orderid;
   }


   property String^ OrderID 
   {
      String^ get()
      {
         return this->ordID;
      }

      void set( String^ value )
      {
         this->ordID = value;
      }

   }

};
// End Order class



void FillMyTreeView()
{
   // Add customers to the ArrayList of Customer objects.
   for ( int x = 0; x < 1000; x++ )
   {
      customerArray->Add( gcnew Customer( "Customer " + x ) );
   }
   
   // Add orders to each Customer object in the ArrayList.
   IEnumerator^ myEnum = customerArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Customer^ customer1 = safe_cast<Customer^>(myEnum->Current);
      for ( int y = 0; y < 15; y++ )
      {
         customer1->CustomerOrders->Add( gcnew Order( "Order " + y ) );
      }
   }

   // Display a wait cursor while the TreeNodes are being created.
   ::Cursor::Current = gcnew System::Windows::Forms::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.
   myEnum = customerArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Customer^ customer2 = safe_cast<Customer^>(myEnum->Current);
      treeView1->Nodes->Add( gcnew TreeNode( customer2->CustomerName ) );
      
      // Add a child treenode for each Order object in the current Customer object.
      IEnumerator^ myEnum = customer2->CustomerOrders->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Order^ order1 = safe_cast<Order^>(myEnum->Current);
         treeView1->Nodes[ customerArray->IndexOf( customer2 ) ]->Nodes->Add( gcnew TreeNode( customer2->CustomerName + "." + order1->OrderID ) );
      }
   }
   
   // Reset the cursor to the default for all controls.
   ::Cursor::Current = Cursors::Default;
   
   // Begin repainting the TreeView.
   treeView1->EndUpdate();
}

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

Public Class Customer
   Inherits [Object]
   Private custName As String = ""
   Friend custOrders As New ArrayList()

   Public Sub New(ByVal customername As String)
      Me.custName = customername
   End Sub

   Public Property CustomerName() As String
      Get
         Return Me.custName
      End Get
      Set(ByVal Value As String)
         Me.custName = Value
      End Set
   End Property

   Public ReadOnly Property CustomerOrders() As ArrayList
      Get
         Return Me.custOrders
      End Get
   End Property
End Class


Public Class Order
   Inherits [Object]
   Private ordID As String

   Public Sub New(ByVal orderid As String)
      Me.ordID = orderid
   End Sub

   Public Property OrderID() As String
      Get
         Return Me.ordID
      End Get
      Set(ByVal Value As String)
         Me.ordID = Value
      End Set
   End Property
End Class

' Create a new ArrayList to hold the Customer objects.
Private customerArray As New ArrayList()

Private Sub FillMyTreeView()
   ' Add customers to the ArrayList of Customer objects.
   Dim x As Integer
   For x = 0 To 999
      customerArray.Add(New Customer("Customer" + x.ToString()))
   Next x

   ' Add orders to each Customer object in the ArrayList.
   Dim customer1 As Customer
   For Each customer1 In customerArray
      Dim y As Integer
      For y = 0 To 14
         customer1.CustomerOrders.Add(New Order("Order" + y.ToString()))
      Next y
   Next customer1

   ' 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.
   Dim customer2 As Customer
   For Each customer2 In customerArray
      treeView1.Nodes.Add(New TreeNode(customer2.CustomerName))

      ' Add a child TreeNode for each Order object in the current Customer object.
      Dim order1 As Order
      For Each order1 In customer2.CustomerOrders
         treeView1.Nodes(customerArray.IndexOf(customer2)).Nodes.Add( _
    New TreeNode(customer2.CustomerName + "." + order1.OrderID))
      Next order1
   Next customer2

   ' Reset the cursor to the default for all controls.
   Cursor.Current = System.Windows.Forms.Cursors.Default

   ' Begin repainting the TreeView.
   treeView1.EndUpdate()
End Sub

Poznámky

Kolekce Nodes obsahuje všechny podřízené TreeNode objekty přiřazené k aktuálnímu TreeNodeobjektu . Když to uděláte, můžete přidat, odebrat nebo naklonovat TreeNode; všechny uzly podřízeného stromu se přidají, odeberou nebo naklonují. Každý z nich TreeNode může obsahovat kolekci dalších TreeNode objektů. To může ztížit určení, kde se při TreeView iteraci kolekcí nacházíte. K určení umístění ve stromové struktuře použijte FullPath vlastnost . Řetězec FullPath lze analyzovat pomocí řetězcové PathSeparator hodnoty a určit, kde TreeNode popisek začíná a končí.

Popisek TreeNode se nastavuje explicitním Text nastavením vlastnosti . Alternativou je vytvoření uzlu stromu pomocí jednoho z TreeNode konstruktorů, který má řetězcový parametr, který představuje Text vlastnost . Popisek se zobrazí vedle obrázku TreeNode , pokud se zobrazí.

Chcete-li zobrazit obrázky vedle uzlů stromu, přiřaďte ImageListImageList vlastnost nadřazeného TreeView ovládacího prvku a přiřaďte objekt Image odkazem na hodnotu jeho indexu ImageList ve vlastnosti . ImageIndex Nastavte vlastnost na hodnotu indexu objektuImage, který chcete zobrazit, když TreeNode je v nevybraném stavu. Podobně nastavte SelectedImageIndex vlastnost na hodnotu indexu Image , kterou chcete zobrazit při TreeNode výběru.

Výběr konkrétních uzlů stromu a iterace kolekcí Nodes se dá dosáhnout pomocí následujících hodnot vlastností: FirstNode, LastNode, , NextNode, PrevNode, NextVisibleNode, . PrevVisibleNode TreeNode Přiřaďte vlastnost vrácenou jednou z výše uvedených vlastností k TreeView.SelectedNode vlastnosti , abyste vybrali uzel stromu v ovládacím TreeView prvku.

Uzly stromové struktury je možné rozbalit a zobrazit tak další úroveň uzlů podřízeného stromu. Uživatel může rozbalit TreeNode stisknutím tlačítka plus (+) vedle TreeNode, pokud se zobrazí, nebo můžete rozbalit TreeNode voláním Expand metody . Pokud chcete rozbalit všechny úrovně uzlů podřízeného stromu v kolekci Nodes , zavolejte metodu ExpandAll . Podřízenou TreeNode úroveň můžete sbalit voláním Collapse metody nebo uživatel může stisknout tlačítko minus (-) vedle TreeNode, pokud se zobrazí. Můžete také volat metodu Toggle , která střídá TreeNode mezi rozbaleným a sbaleným stavem.

Uzly stromové struktury můžou volitelně zobrazit zaškrtávací políčko. Pokud chcete zobrazit zaškrtávací políčka, nastavte CheckBoxes vlastnost objektu TreeView na truehodnotu . Pro Checked uzly stromové struktury, které jsou ve zaškrtnutém stavu, je vlastnost nastavená na true hodnotu .

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• TreeView
• TreeNodeCollection
• Postupy: Přidání a odebrání uzlů s ovládacím prvkem Windows Forms TreeView