GETITEMTREE

Desktop

warning

La specifica è deprecata nei sorgenti con STRICT maggiore o uguale a 3

Consente di reperire le informazioni relative ad un determinato nodo dell'albero e restituisce le seguenti informazioni:

• identificatore del nodo (nella variabile ZTNODO o nella variabile indicata su '@DEFTREE);
• descrizione del nodo (nella variabile ZTNODODES$ o nella variabile indicata su '@DEFTREE);
• identificatore del nodo padre (nella variabile ZTNODOPADRE o nella variabile indicata su '@DEFTREE);
• numero di nodi figli del nodo indicato (nella variabile ZTNODI_TOT o nella variabile indicata su '@DEFTREE).

Parametri

Parametro	Definizione	I/O		Versione traduttore	SMP
ID	Stringa
NOMEALBERO	Intero
IDNODO	Intero
DIREZIONE
STATONODO	Intero
SELEZIONATO	Intero

ID

StringaInputValore non necessarioDesktop

Definisce la variabile o la costante di programma che contiene l'identificatore univoco del controllo

NOMEALBERO

InteroInputObbligatorioValore non necessarioDesktop

Variabile di tipo LONG che dovrà contenere l'ID dell'albero

IDNODO

InteroInputObbligatorioValore non necessarioDesktop

Consente di definire la variabile di programma che contiene l'identificatore del nodo di cui reperire le informazioni eventualmente indicate al momento dell'inserimento del nodo sul parametro V[].

note

Il reperimento delle informazioni avviene sul nodo indicato, a meno che non sia stato indicato il parametro DIREZIONE[].

DIREZIONE

InputValore non necessarioDesktop

Consente di indicare la direzione di ricerca.

note

La presenza del parametro determina se la lettura da eseguire è puntuale rispetto all'ID passato o se si vuole leggere il successivo/precedente in base a Direzione.

Se non è indicato il parametro DIREZIONE[] verrà letto il primo nodo che soddisfa le condizioni di uguaglianza.
Se è indicato il parametro DIREZIONE[] verrà letto il nodo precedente o successivo a quello passato nell'ID[]: se l'ID del nodo è vuoto, se la direzione è GIÙ si leggerà a partire dalla radice, se la direzione è SU si leggerà a partire dall'ultimo nodo dell'albero.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

Valore	Descrizione
SU	direzione verso la radice dell'albero
GIU	direzione verso la fine dell'albero

STATONODO

InteroOutputValore non necessarioDesktop

Consente di conoscere lo stato del bottone dell'albero.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

Valore	Descrizione
0	Riga espansa
1	Riga da espandere
2	Riga senza dettaglio (da non espandere)

SELEZIONATO

InteroOutputValore non necessarioDesktop

Consente di reperire l'informazione selezionata del nodo indicato.

Può assumere i seguenti valori:

Valore	Significato
0	Elemento non selezionato
1	Elemento selezionato
2	Elemento parzialmente selezionato