Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe TreeNode

 

Data di pubblicazione: ottobre 2016

Rappresenta un nodo di un TreeView.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)


[SerializableAttribute]
[TypeConverterAttribute(typeof(TreeNodeConverter))]
public class TreeNode : MarshalByRefObject, ICloneable, ISerializable

NomeDescrizione
System_CAPS_pubmethodTreeNode()

Inizializza una nuova istanza della classe TreeNode.

System_CAPS_protmethodTreeNode(SerializationInfo, StreamingContext)

Inizializza una nuova istanza di TreeNode classe utilizzando il contesto e le informazioni di serializzazione specificato.

System_CAPS_pubmethodTreeNode(String)

Inizializza una nuova istanza di TreeNode classe con il testo dell'etichetta specificata.

System_CAPS_pubmethodTreeNode(String, Int32, Int32)

Inizializza una nuova istanza di TreeNode classe con le immagini da visualizzare quando il nodo dell'albero è stato selezionato ed e il testo dell'etichetta specificata.

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

Inizializza una nuova istanza di TreeNode con il testo dell'etichetta specificata, i nodi figlio e le immagini da visualizzare quando il nodo dell'albero è stato selezionato e.

System_CAPS_pubmethodTreeNode(String, TreeNode[])

Inizializza una nuova istanza di TreeNode classe con i nodi dell'albero specificato etichetta di testo e figlio.

NomeDescrizione
System_CAPS_pubpropertyBackColor

Ottiene o imposta il colore di sfondo del nodo dell'albero.

System_CAPS_pubpropertyBounds

Ottiene i limiti del nodo dell'albero.

System_CAPS_pubpropertyChecked

Ottiene o imposta un valore che indica se il nodo dell'albero è selezionato.

System_CAPS_pubpropertyContextMenu

Ottiene il menu di scelta rapida associato a questo nodo dell'albero.

System_CAPS_pubpropertyContextMenuStrip

Ottiene o imposta il menu di scelta rapida associato al nodo dell'albero.

System_CAPS_pubpropertyFirstNode

Ottiene il primo elemento figlio di nodo dell'albero nell'insieme dei nodi dell'albero.

System_CAPS_pubpropertyForeColor

Ottiene o imposta il colore di primo piano del nodo dell'albero.

System_CAPS_pubpropertyFullPath

Ottiene il percorso dal nodo radice dell'albero al nodo della struttura corrente.

System_CAPS_pubpropertyHandle

Ottiene l'handle del nodo dell'albero.

System_CAPS_pubpropertyImageIndex

Ottiene o imposta il valore di indice di elenco immagini dell'immagine visualizzata quando il nodo dell'albero è non selezionato.

System_CAPS_pubpropertyImageKey

Ottiene o imposta la chiave per l'immagine associata a questo nodo dell'albero quando il nodo è in uno stato deselezionato.

System_CAPS_pubpropertyIndex

Ottiene la posizione del nodo dell'albero nell'insieme dei nodi dell'albero.

System_CAPS_pubpropertyIsEditing

Ottiene un valore che indica se il nodo dell'albero è in uno stato modificabile.

System_CAPS_pubpropertyIsExpanded

Ottiene un valore che indica se il nodo dell'albero è stato espanso.

System_CAPS_pubpropertyIsSelected

Ottiene un valore che indica se il nodo dell'albero è nello stato selezionato.

System_CAPS_pubpropertyIsVisible

Ottiene un valore che indica se il nodo dell'albero è visibile o parzialmente visibile.

System_CAPS_pubpropertyLastNode

Ottiene l'ultimo elemento figlio di nodo dell'albero.

System_CAPS_pubpropertyLevel

Ottiene la profondità del nodo nella struttura ad albero in base zero di TreeView controllo.

System_CAPS_pubpropertyName

Ottiene o imposta il nome del nodo dell'albero.

System_CAPS_pubpropertyNextNode

Ottiene il nodo dell'albero di pari livello successivo.

System_CAPS_pubpropertyNextVisibleNode

Ottiene il nodo dell'albero visibile successivo.

System_CAPS_pubpropertyNodeFont

Ottiene o imposta il tipo di carattere utilizzato per visualizzare il testo sull'etichetta del nodo dell'albero.

System_CAPS_pubpropertyNodes

Ottiene la raccolta di TreeNode oggetti assegnati al nodo della struttura corrente.

System_CAPS_pubpropertyParent

Ottiene l'elemento padre come nodo dell'albero del nodo della struttura corrente.

System_CAPS_pubpropertyPrevNode

Ottiene il nodo dell'albero di pari livello precedente.

System_CAPS_pubpropertyPrevVisibleNode

Ottiene il nodo dell'albero visibile precedente.

System_CAPS_pubpropertySelectedImageIndex

Ottiene o imposta il valore di indice di elenco immagini dell'immagine che viene visualizzata quando il nodo dell'albero è nello stato selezionato.

System_CAPS_pubpropertySelectedImageKey

Ottiene o imposta la chiave dell'immagine visualizzata nel nodo della struttura quando è selezionato.

System_CAPS_pubpropertyStateImageIndex

Ottiene o imposta l'indice dell'immagine che viene utilizzato per indicare lo stato di TreeNode quando l'elemento padre TreeView ha relativo CheckBoxes impostata su false.

System_CAPS_pubpropertyStateImageKey

Ottiene o imposta la chiave dell'immagine che viene utilizzato per indicare lo stato di TreeNode quando l'elemento padre TreeView ha relativo CheckBoxes impostata su false.

System_CAPS_pubpropertyTag

Ottiene o imposta l'oggetto che contiene i dati sul nodo dell'albero.

System_CAPS_pubpropertyText

Ottiene o imposta il testo visualizzato nell'etichetta del nodo dell'albero.

System_CAPS_pubpropertyToolTipText

Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato su un TreeNode.

System_CAPS_pubpropertyTreeView

Ottiene l'elemento padre di visualizzazione albero in cui è assegnato il nodo dell'albero.

NomeDescrizione
System_CAPS_pubmethodBeginEdit()

Inizializza la modifica dell'etichetta del nodo dell'albero.

System_CAPS_pubmethodClone()

Copia l'intero sottoalbero di questo nodo della struttura e il nodo dell'albero.

System_CAPS_pubmethodCollapse()

Consente di comprimere il nodo dell'albero.

System_CAPS_pubmethodCollapse(Boolean)

Comprime il TreeNode ed eventualmente i relativi elementi figlio.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un oggetto che contiene le informazioni necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.(Ereditato da MarshalByRefObject.)

System_CAPS_protmethodDeserialize(SerializationInfo, StreamingContext)

Carica lo stato del TreeNode dall'oggetto specificato SerializationInfo.

System_CAPS_pubmethodEndEdit(Boolean)

Termina la modifica dell'etichetta del nodo dell'albero.

System_CAPS_pubmethodEnsureVisible()

Assicura che il nodo dell'albero è visibile, espandendo i nodi e scorrendo il controllo di visualizzazione albero in base alle esigenze.

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodExpand()

Espande il nodo dell'albero.

System_CAPS_pubmethodExpandAll()

Espande tutti i nodi figlio.

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodSystem_CAPS_staticFromHandle(TreeView, IntPtr)

Controllo di visualizzazione restituisce il nodo dell'albero con gli handle e assegnato alla struttura ad albero specificato.

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodGetNodeCount(Boolean)

Restituisce il numero di nodi figlio dell'albero.

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.(Ereditato da MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficiale dell'oggetto corrente MarshalByRefObject oggetto.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodRemove()

Rimuove il nodo della struttura corrente dal controllo di visualizzazione albero.

System_CAPS_protmethodSerialize(SerializationInfo, StreamingContext)

Salva lo stato del TreeNode specificato SerializationInfo.

System_CAPS_pubmethodToggle()

Attiva o disattiva il nodo dell'albero a uno stato espanso o compresso.

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Esegue l'override di Object.ToString().)

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un oggetto di informazioni di serializzazione con i dati necessari per serializzare il TreeNode.

Il Nodes insieme contiene tutti gli elementi figlio TreeNode oggetti assegnati al corrente TreeNode. È possibile aggiungere, rimuovere o clonare un TreeNode; in tal caso, tutti gli alberi figlio nodi aggiunti, rimossi o clonati. Ogni TreeNode può contenere un insieme di altri TreeNode oggetti. Questa operazione può rendere difficile determinare dove ti trovi il TreeView quando si scorre la raccolta. Per determinare la posizione in una struttura ad albero, utilizzare il FullPath proprietà. Il FullPath stringa può essere analizzata utilizzando il PathSeparator stringa di valore per determinare dove un TreeNode etichetta inizia e finisce.

Il TreeNode è impostata l'etichetta impostando il Text proprietà in modo esplicito. L'alternativa consiste nel creare il nodo dell'albero utilizzando uno del TreeNode costruttori che dispone di un parametro di stringa che rappresenta il Text proprietà. L'etichetta viene visualizzata accanto al TreeNode l'immagine, se presente.

Per visualizzare le immagini accanto ai nodi dell'albero, assegnare un ImageList per la ImageList proprietà dell'elemento padre TreeView controllare e assegnare un Image riportando il relativo valore di indice nel ImageList proprietà. Impostare il ImageIndex proprietà per il valore di indice di Image da visualizzare quando il TreeNode è in uno stato deselezionato. Allo stesso modo, impostare la SelectedImageIndex proprietà per il valore di indice di Image da visualizzare quando il TreeNode è selezionata.

Per selezionare specifici nodi della struttura e scorrere il Nodes raccolta può essere ottenuta utilizzando i valori delle proprietà seguenti: FirstNode, LastNode, NextNode, PrevNode, NextVisibleNode, PrevVisibleNode. Assegnare il TreeNode restituito da una delle proprietà menzionate in precedenza per il TreeView.SelectedNode proprietà per selezionare il nodo della struttura nel TreeView controllo.

I nodi dell'albero possono essere espansa per visualizzare il livello successivo di nodi figlio dell'albero. L'utente può espandere il TreeNode facendo clic sul segno più (+) accanto al pulsante il TreeNode, se presente, oppure è possibile espandere il TreeNode chiamando il Expand (metodo). Per espandere tutti i livelli dei nodi figlio della struttura nel Nodes raccolta, chiamare il ExpandAll metodo. È possibile comprimere l'elemento figlio TreeNode livello chiamando il Collapse metodo o l'utente può premere il segno meno pulsante (-) accanto al TreeNode, se presente. È inoltre possibile chiamare il Toggle metodo alternativo di TreeNode tra gli stati espansi e compressi.

I nodi dell'albero anche possibile visualizzare una casella di controllo. Per visualizzare le caselle di controllo, impostare la CheckBoxes proprietà del TreeView a true. Il Checked è impostata su true per nodi dell'albero che si trovano nello stato selezionato.

Esempio di codice seguente consente di visualizzare informazioni sui clienti in un TreeView controllo. I nodi della struttura visualizzare i nomi dei clienti e i nodi figlio visualizzati i numeri di ordine assegnati a ogni cliente. In questo esempio vengono visualizzati 1.000 clienti con 15 ordini. Per evitare di ridisegnare il TreeView soppresso mediante il BeginUpdate e EndUpdate e in attesa Cursor viene visualizzato durante il TreeView Crea e disegna il TreeNode oggetti. In questo esempio è necessario che un Customer oggetto che può contenere una raccolta di Order oggetti. È inoltre necessario avere creato un'istanza di un TreeView control per un Form.


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

.NET Framework
Disponibile da 1.1

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: