Metodo Add (insieme Nodes)
Aggiunge un oggetto Node all'insieme Nodes del controllo Treeview.
Sintassi
oggetto.Add(relativo, relazione, chiave, testo, immagine, immagineselezionata)
La sintassi del metodo Add è composta dalle seguenti parti:
Parte Descrizione
oggetto Obbligatoria.Espressione oggetto che definisce un oggetto dell'elenco "Si applica a".
relativo Facoltativa. Numero di indice o chiave di un oggetto Node preesistente. La relazione tra il nuovo nodo e questo nodo preesistente è indicata nell'argomento successivo, relazione.
relazione Facoltativa. Specifica la posizione relativa dell'oggetto Node, come indicato nella sezione "Impostazioni".
chiave Facoltativa. Stringa univoca, utilizzabile per il recupero dell'oggetto Node con il metodo Item.
testo Obbligatoria. Stringa visualizzata in Node.
immagine Facoltativa. Indice di un'immagine in un controllo ImageList associato.
immagineselezionata Facoltativa. Indice di un'immagine in un controllo ImageList associato, visualizzato quando l'oggetto Node è selezionato.
Impostazioni
Le possibili impostazioni di relazione sono:
Costante Valore Descrizione
tvwFirst 0 Primo. L'oggetto Nodo viene posto prima di tutti gli altri nodi allo stesso livello del nodo indicato in relativo.
tvwLast 1 Ultimo. L'oggetto Node viene posto dopo tutti gli altri nodi allo stesso livello del nodo indicato in relativo. Gli altri oggetti Node aggiunti successivamente devono essere posti dopo un oggetto inserito con tvwLast.
tvwNext 2 (Predefinita) Successivo. L'oggetto Node viene posto dopo del nodo indicato in relativo.
tvwPrevious 3 Precedente. L'oggetto Node viene posto prima del nodo indicato in relativo.
tvwChild 4 (Predefinita) L'oggetto Node diventa un nodo secondario del nodo indicato in relativo.
Nota Se in relativo non è indicato alcun oggetto Node, il nuovo nodo viene posto nell'ultima posizione della gerarchia del nodo contenitore.
Osservazioni
L'insieme Nodes è un insieme in base 1.
Quando viene aggiunto un oggetto Node, ad esso viene assegnato un numero di indice, memorizzato nella proprietà Index dell'oggetto Node. Questo valore è il valore della proprietà Count dell'insieme Node.
Poiché il metodo Add restituisce un riferimento all'oggetto Node appena creato, è consigliabile impostare le proprietà del nuovo oggetto Node in base a tale riferimento. Il codice dell'esempio seguente aggiunge vari oggetti Node con proprietà identiche:
Dim nodX As Node ' Dichiara la variabile oggetto.
Dim I as Integer ' Dichiara una variabile contatore.
For I = 1 to 4
Set nodX = TreeView1.Nodes.Add(,,,"Node " & Cstr(i))
' Utilizza il riferimento per impostare altre proprietà,
' ad esempio Enabled.
nodX.Enabled = True
' Imposta la proprietà Image sull'immagine con indice 3
' in un controllo ImageList associato.
nodX.ExpandedImage = 3
Next I