TreeNode Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un nodo di un controllo TreeView.

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

Ereditarietà: Object

MarshalByRefObject
TreeNode

Derivato: System.ComponentModel.Design.ObjectSelectorEditor.SelectorNode

System.Workflow.ComponentModel.Design.WorkflowOutlineNode

Attributi: TypeConverterAttribute SerializableAttribute

Implementazioni: ICloneable ISerializable

Esempio

Nell'esempio di codice seguente vengono visualizzate le informazioni sui clienti in un TreeView controllo. I nodi dell'albero radice visualizzano i nomi dei clienti e i nodi dell'albero figlio visualizzano i numeri di ordine assegnati a ogni cliente. In questo esempio vengono visualizzati 1.000 clienti con 15 ordini. Il ripainting dell'oggetto TreeView viene eliminato usando i BeginUpdate metodi e EndUpdate e viene visualizzata un'attesa Cursor mentre TreeView crea e disegna gli TreeNode oggetti. In questo esempio è necessario disporre di un Customer oggetto che può contenere una raccolta di Order oggetti. È anche necessario che sia stata creata un'istanza di un TreeView controllo in un Formoggetto .

// 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

Commenti

L'insieme Nodes contiene tutti gli oggetti figlio TreeNode assegnati all'oggetto corrente TreeNode. È possibile aggiungere, rimuovere o clonare un TreeNodeoggetto ; quando si esegue questa operazione, tutti i nodi dell'albero figlio vengono aggiunti, rimossi o clonati. Ognuno TreeNode può contenere una raccolta di altri TreeNode oggetti. Ciò può rendere difficile determinare la posizione in cui si sta eseguendo l'iterazione TreeView tramite la raccolta. Per determinare la posizione in una struttura ad albero, usare la FullPath proprietà . La FullPath stringa può essere analizzata usando il PathSeparator valore stringa per determinare dove inizia e termina un'etichetta TreeNode .

L'etichetta TreeNode viene impostata impostando in modo esplicito la Text proprietà. L'alternativa consiste nel creare il nodo albero usando uno dei TreeNode costruttori con un parametro stringa che rappresenta la Text proprietà. L'etichetta viene visualizzata accanto all'immagine TreeNode , se visualizzata.

Per visualizzare le immagini accanto ai nodi dell'albero, assegnare un ImageList oggetto alla proprietà del controllo padre TreeView e assegnare un Image oggetto facendo riferimento al ImageList relativo valore di indice nella ImageList proprietà. Impostare la ImageIndex proprietà sul valore di indice dell'oggetto Image che si desidera visualizzare quando l'oggetto TreeNode è in uno stato non selezionato. Allo stesso modo, impostare la SelectedImageIndex proprietà sul valore di indice dell'oggetto Image che si desidera visualizzare quando è TreeNode selezionato.

È possibile selezionare nodi ad albero specifici e eseguire l'iterazione della Nodes raccolta usando i valori delle proprietà seguenti: FirstNode, NextNode LastNode NextVisibleNode PrevNode PrevVisibleNode. Assegnare l'oggetto TreeNode restituito da una delle proprietà sopra indicate alla TreeView.SelectedNode proprietà per selezionare il nodo dell'albero nel TreeView controllo.

I nodi albero possono essere espansi per visualizzare il livello successivo di nodi dell'albero figlio. L'utente può espandere il TreeNode premendo il pulsante più (+) accanto a TreeNode, se visualizzato o è possibile espandere l'oggetto TreeNode chiamando il Expand metodo . Per espandere tutti i livelli dei nodi dell'albero Nodes figlio nella raccolta, chiamare il ExpandAll metodo . È possibile comprimere il livello figlio TreeNode chiamando il Collapse metodo oppure l'utente può premere il pulsante meno (-) accanto a TreeNode, se ne viene visualizzato uno. È anche possibile chiamare il Toggle metodo per alternare gli TreeNode stati espansi e compressi.

I nodi della struttura ad albero possono facoltativamente visualizzare una casella di controllo. Per visualizzare le caselle di controllo, impostare la CheckBoxes proprietà di su TreeViewtrue. La Checked proprietà è impostata su true per i nodi della struttura ad albero in uno stato selezionato.

Costruttori

TreeNode()	Inizializza una nuova istanza della classe TreeNode.
TreeNode(SerializationInfo, StreamingContext)	Inizializza una nuova istanza della classe TreeNode utilizzando le informazioni di serializzazione e il contesto specificati.
TreeNode(String)	Inizializza una nuova istanza della classe TreeNode con il testo di etichetta specificato.
TreeNode(String, Int32, Int32)	Inizializza una nuova istanza della classe TreeNode con le immagini e il testo di etichetta specificato da visualizzare quando il nodo della struttura ad albero si trova nello stato selezionato e non selezionato.
TreeNode(String, Int32, Int32, TreeNode[])	Inizializza una nuova istanza della classe TreeNode con le immagini, i nodi figli della struttura ad albero e il testo di etichetta specificato da visualizzare quando il nodo della struttura ad albero si trova nello stato selezionato e non selezionato.
TreeNode(String, TreeNode[])	Inizializza una nuova istanza della classe TreeNode con il testo di etichetta specificato e i nodi figli della struttura ad albero.

Proprietà

BackColor	Ottiene o imposta il colore di sfondo del nodo della struttura ad albero.
Bounds	Ottiene i limiti del nodo della struttura ad albero.
Checked	Ottiene o imposta un valore che indica se lo stato del nodo della struttura ad albero è di selezione.
ContextMenu	Ottiene il menu di scelta rapida che è associato a questo nodo della struttura ad albero.
ContextMenuStrip	Ottiene o imposta il menu di scelta rapida associato a questo nodo della struttura ad albero.
FirstNode	Ottiene il primo nodo figlio della struttura ad albero dell'insieme dei nodi della struttura ad albero.
ForeColor	Ottiene o imposta il colore di primo piano del nodo della struttura ad albero.
FullPath	Ottiene il percorso dal nodo radice della struttura ad albero al nodo della struttura ad albero corrente.
Handle	Ottiene gli handle del nodo della struttura ad albero.
ImageIndex	Ottiene o imposta il valore di indice dell'elenco immagini dell'immagine visualizzata quando lo stato del nodo della struttura ad albero è non selezionato.
ImageKey	Ottiene o imposta la chiave per l'immagine associata a questo nodo della struttura ad albero quando il nodo è in uno stato deselezionato.
Index	Ottiene la posizione del nodo della struttura ad albero nell'insieme che lo contiene.
IsEditing	Ottiene un valore che indica se lo stato del nodo della struttura ad albero è modificabile.
IsExpanded	Ottiene un valore che indica se lo stato del nodo della struttura ad albero è espanso.
IsSelected	Ottiene un valore che indica se lo stato del nodo della struttura ad albero è selezionato.
IsVisible	Ottiene un valore che indica se il nodo della struttura ad albero è visibile o parzialmente visibile.
LastNode	Ottiene l'ultimo nodo figlio della struttura ad albero.
Level	Ottiene la profondità in base zero del nodo della struttura ad albero nel controllo TreeView.
Name	Ottiene o imposta il nome del nodo della struttura ad albero.
NextNode	Ottiene il successivo nodo della struttura ad albero di pari livello.
NextVisibleNode	Ottiene il successivo nodo della struttura ad albero visibile.
NodeFont	Ottiene o imposta il carattere utilizzato per visualizzare il testo sull'etichetta del nodo della struttura ad albero.
Nodes	Ottiene l'insieme degli oggetti TreeNode assegnati al nodo della struttura ad albero corrente.
Parent	Ottiene il nodo padre della struttura ad albero del nodo della struttura ad albero corrente.
PrevNode	Ottiene il precedente nodo della struttura ad albero di pari livello.
PrevVisibleNode	Ottiene il precedente nodo della struttura ad albero visibile.
SelectedImageIndex	Ottiene o imposta il valore di indice dell'elenco immagini dell'immagine visualizzata quando lo stato del nodo della struttura ad albero è selezionato.
SelectedImageKey	Ottiene o imposta la chiave dell'immagine visualizzata nel nodo della struttura ad albero quando è in uno stato selezionato.
StateImageIndex	Ottiene o imposta l'indice dell'immagine utilizzata per indicare lo stato dell'oggetto TreeNode quando nel controllo padre TreeView la proprietà CheckBoxes è impostata su `false`.
StateImageKey	Ottiene o imposta la chiave dell'immagine utilizzata per indicare lo stato dell'oggetto TreeNode quando nel controllo padre TreeView la proprietà CheckBoxes è impostata su `false`.
Tag	Ottiene o imposta l'oggetto che contiene i dati relativi al nodo della struttura ad albero.
Text	Ottiene o imposta il testo visualizzato nell’etichetta del nodo della struttura ad albero.
ToolTipText	Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato su un controllo TreeNode.
TreeView	Ottiene la visualizzazione struttura ad albero padre a cui è assegnato il nodo della struttura ad albero.

Metodi

BeginEdit()	Inizializza la modifica dell'etichetta del nodo della struttura ad albero.
Clone()	Copia il nodo della struttura ad albero e l'intero sottoalbero di questo nodo della struttura ad albero.
Collapse()	Comprime il nodo della struttura ad albero.
Collapse(Boolean)	Comprime l'oggetto TreeNode ed eventualmente i relativi figli.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Deserialize(SerializationInfo, StreamingContext)	Carica lo stato dell'oggetto TreeNode dall'oggetto SerializationInfo specificato.
EndEdit(Boolean)	Termina la modifica dell'etichetta del nodo della struttura ad albero.
EnsureVisible()	Garantisce che il nodo della struttura ad albero sia visibile, espandendo i nodi e scorrendo il controllo di visualizzazione ad albero a seconda delle esigenze.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Expand()	Espande il nodo della struttura ad albero.
ExpandAll()	Espande tutti i nodi figli della struttura ad albero.
FromHandle(TreeView, IntPtr)	Restituisce il nodo della struttura ad albero con l'handle specificato e assegnato al controllo di visualizzazione ad albero specificato.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetNodeCount(Boolean)	Restituisce il numero dei nodi figli della struttura ad albero.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Remove()	Rimuove il nodo della struttura ad albero corrente dal controllo di visualizzazione ad albero.
Serialize(SerializationInfo, StreamingContext)	Salva lo stato dell'oggetto TreeNode nell'oggetto SerializationInfo specificato.
Toggle()	Modifica lo stato del nodo della struttura ad albero da espanso a compresso e viceversa.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente.

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un oggetto di informazioni di serializzazione con i dati necessari per serializzare l'istanza di TreeNode.

Si applica a