DEFTREE
Dalla versione 26.0 è consigliabile usare la specifica '@DEFADVTREE
Consente la definizione di un controllo albero.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| ID | Stringa | ||||
| NOME | Intero | ||||
| RET | |||||
| POS | |||||
| DIM | |||||
| INSNODI | Azione | ||||
| INNODO | Azione | ||||
| MULTISEL | Intero | ||||
| NODOCORRENTE | Intero | ||||
| PADRECORRENTE | Intero | ||||
| TOTFIGLI | Intero | ||||
| DINAMICO | |||||
| V | |||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| STILE | Stringa | ||||
| COMPRIMIVOCIESPANSE | Intero | ||||
| IDMENU | Stringa | ||||
| TOOLBAR | Intero | ||||
| FUNZIONI | |||||
| ABILITACURSORE | Intero | ||||
| AZIONEINVIO | |||||
| NOICONE | Intero | ||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO | |||||
| DOPPIOCLICK | Numerico | ||||
| CLICK | Numerico | ||||
| DRAG | |||||
| DROP |
ID
Definisce la variabile o la costante di programma che contiene l'identificatore univoco del controllo.
Viene utilizzato dall'ambiente per gestire le personalizzazioni effettuate durante l'esecuzione del programma.
NOME
Variabile di tipo LONG che dovrà contenere l'ID dell'albero
RET
Coordinate della cella del reticolo da associare al controllo.
Queste informazioni hanno lo scopo di inserire il controllo nella logica di gestione degli spostamenti sulla videata.
POS
Posizionamento del controllo.
Consente di indicare la riga e la colonna. Per entrambi è possibile specificare l'unità di misura.
POS[RigaVid [UnitàMisura], ColonnaVid [UnitàMisura]]
L'unità di misura può essere: 'C' per il posizionamento a caratteri e 'P' per il posizionamento in pixel. L'indicazione è opzionale, se omesso si assume 'C' come default.
DIM
Dimensione del controllo.
Consente di indicare l'altezza e la larghezza. Per entrambi è possibile specificare l'unità di misura.
DIM[Altezza [UnitàMisura], Larghezza [UnitàMisura]]
L'unità di misura può essere: 'C' per il posizionamento a caratteri e 'P' per il posizionamento in pixel. L'indicazione è opzionale, se omesso si assume 'C' come default.
INSNODI
Attributo per il caricamento della gerarchia dell'albero.
Consente di definire un richiamo ad una routine del programma applicativo che utilizzando la specifica '@INSITEMTREE inserisce e definisce la gerarchia del controllo.
E' ammesso l'utilizzo di più istruzioni separate da carattere ':'. Non è ammesso l'utilizzo di istruzioni 'GOTO.
INNODO
Consente di definire un'azione da eseguire quando un nodo diventa il nodo corrente
MULTISEL
Consente di attivare la multiselezione per i nodi dell'albero.
L'attivazione della multiselezione fa in modo che al fianco di ogni nodo/foglia presente nell'albero compaia una checkbox di selezione.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
NODOCORRENTE
Consente di definire la variabile contenente l'identificatore dell'elemento corrente dell'albero.
La variabile di sistema ZTNODO contiene l'identificatore del nodo corrente dell'albero.
Per questo motivo se si omette questo attributo è possibile utilizzare questa variabile per conoscere l'identificatore che possiede il fuoco.
Se in una stessa videata sono però presenti due alberi, per evitare ambiguità è necessario definire l'attributo NODOCORRENTE.
PADRECORRENTE
Consente di definire la variabile contenente l'identificatore dell'elemento padre dell'elemento corrente dell'albero.
La variabile di sistema ZTNODOPADRE contiene l'identificatore del nodo padre dell'elemento corrente dell'albero.
Per questo motivo se si omette questo attributo è possibile utilizzare questa variabile per conoscere l'identificatore del padre dell'elemento che possiede il fuoco.
Se in una stessa videata sono però presenti due alberi, per evitare ambiguità è necessario definire l'attributo PADRECORRENTE.
TOTFIGLI
Consente la definizione della variabile contenente il numero di figli dell'elemento padre dell'elemento corrente.
La variabile di sistema ZTNODI_TOT contiene il numero di figli dell'elemento corrente.
Per questo motivo se si omette questo attributo è possibile utilizzare questa variabile per conoscere il numero di fratelli dell'elemento che possiede il fuoco.
Se in una stessa videata sono però presenti due alberi, per evitare ambiguità è necessario definire l'attributo TOTFIGLI.
DINAMICO
Attributo che abilita la modalità dinamica di caricamento dell'albero.
Se indicato, al momento della costruzione verrà richiesto il caricamento del primo livello dell'albero; nel momento in cui si tenta di espandere un nodo, verrà richiesta la lettura e quindi il caricamento nell'albero dei figli del nodo corrente.
V
Consente di definire l'elenco di valori associati ai singoli nodi di un albero.
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.
NASCOSTO
Permette di indicare la condizione per nascondere il controllo.
La condizione viene applicata solo in fase di creazione della videata (in contesto desktop).
DISABILITATO
Permette di indicare la condizione per disabilitare il controllo.
STILE
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.
COMPRIMIVOCIESPANSE
Consente di definire una espressione per l'attivazione della compressione automatica dei rami dell'albero.
Se l'espressione risulta vera la funzione viene abilitata e l'albero potrà avere aperto solamente un nodo nel livello selezionato, gli altri verranno automaticamente chiusi.
Se l'espressione non risulta presente, la funzione risulterà non abilitata
IDMENU
Consente di specificare se il controllo dispone di un proprio menù di contesto definito in precedenza mediante una specifica '@DEFCONTEXTMENU.
TOOLBAR
Permette di controllare la visualizzazione della toolbar
FUNZIONI
Permette di abilitare una serie di funzionalità e la loro modalità di fruizione:
- Disabilitazione della ricerca
ABILITACURSORE
Consente di identificare l'attivazione della modalità di gestione del Cursore.
AZIONEINVIO
Consente di indicare l'ID del tasto da simulare alla pressione del tasto INVIO.
L'utilizzo del parametro implica l'utilizzo del parametro ID
NOICONE
Attributo che indica la creazione dei rami dell'albero senza icone.
Di default l'attributo non è attivo e i rami dell'albero utilizzano un set di icone standard.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | Visualizza le immagini |
1 | Non visualizzare le immagini |
GRID
Consente di indicare le Attached Property per pannello di tipo Grid.
STACK
Consente di indicare le Attached Property per pannello di tipo Stack.
EXPANDER
Consente di indicare le Attached Property per pannello di tipo Expander
DOCK
Consente di indicare se l'oggetto deve occupare tutto lo spazio del DockPanel in verticale e/o in orizzontale (possono essere indicati entrambi).
PERSONALIZZABILE
Definisce l'oggetto grafico come personalizzabile dall'utente in fase di runtime.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LINKTO
Consente di creare un legame tra due controlli esistenti all'interno della stessa videata.
DOPPIOCLICK
Consente di indicare il comportamento che deve avere l'albero se viene effettuato il doppio click su qualsiasi dei nodi inseiriti.
Se non indicato, il comportamento standard prevede la simulazione della pressione del tasto F10, che negli ambiti legati alle videate composte simula lo spostamento e quindi la sincronizzazione tra principale e secondaria.
CLICK
Consente di intercettare se il nodo dell'albero viene selezionato tramite il mouse con un singolo click.
Il parametro è utile per pilotare i meccanismi di sincronizzazione di eventuali altri controlli video e consentire una navigazione simile a quella di esplora risorse di Windows.
DRAG
Consente di definire il comportamento da attenere nel caso in cui venga iniziata un'operazione di trascinamento di un oggetto (nodo) dell'albero.
DROP
Consente di definire il comportamento da attenere nel caso in cui venga rilasciato sul controllo un oggetto del tipo indicato.
Il nome dell'oggetto ha una duplice funzione:
-
consente di riconoscere l'oggetto trascinato sul controllo al fine di modificare il cursore del mouse, indicando che è possibile un'operazione di drop;
-
consente di riconoscere l'oggetto rilasciato sul controllo al fine di eseguire la corrispondente azione.