INSITEMTREE

DesktopWeb

Consente di inserire un elemento all'interno della struttura gerarchica dell'albero.

Dopo aver eseguito l'inserimento del nodo, vengono rese disponibili le seguenti variabili:

• ZTNODO identificatore del nodo inserito.
• ZTNODODES$ descrizione del nodo inserito.
• ZTNODOPADRE identificatore del nodo padre del nodo inserito.
• ZTNODI_TOT numero totale di figli del nodo.

Parametri

Parametro	Definizione	I/O		Versione traduttore	SMP
NOMEALBERO	Intero
IDNODO	Intero
IDPADRE	Intero
SELEZIONABILE	Intero
SPUNTABILE	Intero
SELEZIONATO	Intero
SELNODO	Azione
NODOCORRENTE	Intero
DES	Stringa
INNODO	Azione
OUTNODO	Azione
INGRESSONODO	Azione
POSIZIONE
IMMAGINE	Stringa
HAFIGLI	Intero
HELP	Variabile
V
FILTROPADRE
IDMENU	Stringa
STILE	Stringa
IMAGE	Variabile

NOMEALBERO

InteroInputObbligatorioValore non necessarioDesktopWeb

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

IDNODO

InteroOutputValore non necessarioDesktop

Consente di definire la variabile di programma in cui verrà restituito l'identificatore del nodo inserito

IDPADRE

InteroInputValore non necessarioDesktopWeb

Consente di definire la variabile di programma che contiene l'identificatore del nodo padre, sotto cui si vuole che venga inserito l'elemento corrente.

SELEZIONABILE

InteroInputValore non necessarioDesktopWeb

Attributo che consente al nodo di essere selezionabile.

note

Un nodo non risulta selezionabile se il 'doppio click' o i tasti 'Invio' e 'F10' sul nodo non eseguono alcuna azione.
È consentito su tali nodi il posizionamento mediante tastiera e mouse.

Se non è presente questo attributo il nodo risulta selezionabile.

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

Valore	Descrizione
0	nodo non selezionabile
1	nodo selezionabile

SPUNTABILE

InteroInputValore non necessarioDesktop

Consente la disabilitazione del solo checkbox di selezione del nodo, se attiva la multiselezione sul parametro MULTISEL[] della specifica '@DEFTREE.

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

Valore	Descrizione
0	Il check-box di selezione multipla risulta abilitato
1	Il check-box di selezione multipla risulta disabilitato

SELEZIONATO

InteroInputValore non necessarioDesktop

Consente l'indicazione dello stato iniziale della checkbox di selezione del nodo, se attiva la multiselezione sul parametro MULTISEL[] della specifica '@DEFTREE.

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

Valore	Descrizione
0	Nodo non selezionato
1	Nodo selezionato

SELNODO

AzioneInputValore non necessarioDesktop

Consente di definire l'azione da eseguire alla selezione/deselezione dell'elemento se attiva la multiselezione sul parametro MULTISEL[] della specifica '@DEFTREE.

note

L'azione viene eseguita dopo la callBack INNODO[] e dopo aver valorizzato l'elemento.
E' ammesso l'utilizzo di più istruzioni separate da carattere ':'.
Non è ammesso l'utilizzo di istruzioni 'GOTO.

NODOCORRENTE

InteroInputValore non necessarioDesktopWeb

Consente di stabilire se il nodo inserito deve essere quello corrente.

Se non è presente questo attributo si assume che il nodo non sia quello corrente.

suggerimento

Per eseguire le azioni di ingresso riga, in fase d'inserimento del nodo, utilizzare il parametro INGRESSONODO[].

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

Valore	Descrizione
0	nodo non corrente
1	nodo corrente

DES

StringaInputValore non necessarioDesktopWeb

Consente di definire il testo da riportare come descrizione visibile del nodo.

INNODO

AzioneInputValore non necessarioDesktop

Consente di definire l'azione da eseguire in ingresso sul nodo.

note

E' ammesso l'utilizzo di più istruzioni separate da carattere ':'.
Non è ammesso l'utilizzo di istruzioni 'GOTO.

OUTNODO

AzioneInputValore non necessarioDesktop

Consente di definire l'azione da eseguire in uscita dal nodo da eseguire prima che il fuoco venga attribuito ad un altro controllo.

note

E' ammesso l'utilizzo di più istruzioni separate da carattere ':'.
Non è ammesso l'utilizzo di istruzioni 'GOTO.

INGRESSONODO

AzioneInputValore non necessarioDesktop

Consente di eseguire la routine di INNODO[] nel momento in cui si inserisce l'elemento dell'albero.

Può assumere i seguenti valori:

Valore	Descrizione
0	L'inserimento del nodo non genera nessuna callBack associata
1	L'inserimento del nodo genera automaticamente la callBack INNODO

POSIZIONE

InputValore non necessarioDesktop

Consente di definire la posizione in cui si vuole venga inserito il nodo, rispetto al nodo padre indicato.

Se è omesso questo parametro si assume 'ULTIMO' come default.

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

Valore	Descrizione
PRIMO	il nodo viene inserito come primo figlio del nodo padre
ULTIMO	il nodo viene inserito come ultimo figlio del nodo padre
ORDINATO	il nodo viene inserito in ordine rispetto agli altri figli del padre, sulla base della descrizione fornita

IMMAGINE

StringaInputValore non necessarioDesktopWeb

Consente di definire il nome dell'immagine da utilizzare per rappresentare il nodo sull'albero.

note

Se non specificato il parametro, le immagini associate ai nodi saranno quelle di default: icone cartella per i nodi con figli ed icone testo per le foglie.

HAFIGLI

InteroInputValore non necessarioDesktop

Consente di stabilire se il nodo inserito contiene dei figli oppure no.

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

Valore	Descrizione
0	il nodo non ha figli e quindi è una foglia
1	il nodo ha dei figli

HELP

VariabileInputValore non necessarioDesktopWeb

SottoParametri

Consente di definire il messaggio di Help.

V

InputValore non necessarioDesktopWeb

SottoParametri

Consente di definire l'elenco di valori associati ai singoli nodi di un albero.

note

Queste informazioni sono utilizzate sulla varie operazioni di selezione di un nodo, entrata nodo, uscita nodo per determinare il nodo su cui si sta svolgendo l'operazione.

Queste variabili devono essere usate per avere un riferimento univoco ai singoli nodi della gerarchia.

FILTROPADRE

InputValore non necessarioDesktopWeb

SottoParametri

Consente di definire l'elenco di filtri per la selezione del nodo superiore.

Devono essere usate per avere un riferimento univoco ai singoli nodi della gerarchia.

IDMENU

StringaInputValore non necessarioDesktop

Consente di specificare se il nodo dispone di un proprio menù di contesto definito in precedenza mediante una specifica '@DEFCONTEXTMENU.

STILE

StringaInputValore non necessarioDesktopWeb

Attributo di definizione dello stile da applicare al controllo.
Può essere una delle costanti definite in BC per gli stili oppure uno stile precedentemente definito tramite @DEFSTYLE.

IMAGE

VariabileInputValore non necessarioDesktop

Consente di indicare il nome del file contenente l'immagine o la risorsa immagine da visualizzare.