DEFLISTBOX
La funzione '@DEFLISTBOX, consente di creare una Lista, all'interno di una videata, cioè all'interno delle specifiche '@DEFVID e '@RUNVID. La List Box crea un elenco di dati selezionabili dall'utente. Attraverso la selezione di questi dati è possibile pilotare l'aggiornamento di altri controlli, o di variabili legate alla videata.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOME | Intero | 31.5 | |||
| IMMAGINE | 31.5 | ||||
| MULTISEL | Intero | 31.5 | |||
| COLLEZIONEDATI | Collezione di BC_VID_LISTBOX_ITEM | 31.5 | |||
| ID | Stringa | ||||
| IDLISTBOX | Variabili | ||||
| POS | |||||
| DIM | |||||
| RET | |||||
| RIDIMENSIONABILE | |||||
| STILE | Stringa | ||||
| AZIONE | |||||
| AZIONEDEFAULT | |||||
| PAGINAATTIVA | Variabile | ||||
| PAGINASELEZIONATA | Intero | ||||
| DISABILITATO | Condizione | ||||
| ELEMENTI | |||||
| ELEMENTO | |||||
| SELELEMENTO | Azione | ||||
| ALTEZZARIGA | Double | ||||
| RIGHEDESCRIZIONE | Intero | ||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO | |||||
| FUNZIONI |
IMMAGINE
Permette di indicare le immagini da associare alle voci dinamiche. Il parametro può essere ripetuto.
MULTISEL
Indica se la listbox supporta la multiselezione o meno
COLLEZIONEDATI
Collezione di elementi da mostrare in listbox
L'utilizzo del parametro implica l'utilizzo del parametro NOME
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.
IDLISTBOX
Variabile contenente l'identificativo della ListBox. IdListBox: La variabile deve essere di tipo Long.
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.
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.
RIDIMENSIONABILE
Attributo che specifica in che modo si vuole ridimensionare la griglia.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
TUTTO | L'oggetto si ridimensionerà sia verso destra che verso il basso |
DESTRA | L'oggetto si ridimensionerà solamente verso destra |
BASSO | L'oggetto si ridimensionerà solamente verso il basso |
NESSUNO | L'oggetto diventerà un oggetto NON ridimensionabile |
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.
Lo stile sarà applicato solo all'etichetta del controllo.
AZIONE
Definisce l'azione da eseguire quando uno degli elementi della ListBox viene premuto con il mouse.
AZIONEDEFAULT
Definisce l'azione di default da eseguire quando:
- L'utente effettua un doppio click su un elemento
- Dopo aver selezionato un elemento si preme il tasto INVIO (senza aver definito l'F10) AzioneDefault: Sequeza di istruzioni BC o chiamata ad una subroutine. Non è possibile inserire in tale parametro le istruzioni 'GOTO' mentre è consentito inserire una o più operazioni semplici (Assegnamenti) utilizzando il carattere ':' come separatore fra istruzioni.
PAGINAATTIVA
Consente di definire l'elemento selezionato all'interno della ListBox. All'avvio verrà eseguita l'azione relativa della pagina selezionata (in questo caso la pagina attiva) PaginaAttiva: Può essere una costante o una variabile di tipo intero.
PAGINASELEZIONATA
Restituisce al programma BC una variabile contenente l'indice dell'elemento selezionato all'interno della ListBox. Tale variabile deve essere utilizzato all'interno della callBack richiamata dal parametro AZIONE. PaginalClick: Deve essere una variabile di tipo intero.
DISABILITATO
Attributo che consente di disabilitare la ListBox.
ELEMENTI
Permette di definire, attraverso l'utilizzo di una struttura dinamica del programma, la composizione della ListBox. Se si utilizza il parametro ELEMENTI, non sarà possibile utilizzare il parametro ELEMENTO.
ELEMENTO
Permette di definire, ogni singolo elemento presente all'interno della ListBox. Il parametro ELEMENTO andrà ripetuto per ogni elemento che si vuole inserire. Se si utilizza il parametro ELEMENTO, non sarà possibile utilizzare il parametro ELEMENTI.
SELELEMENTO
Definisce l'azione da eseguire a seguito della spunta di un dato elemento. L'azione verrà richiamata al termine della valorizzazione interna della struttura, quindi tramite il parametro PAGINASELEZIONATA e la struttura dinamica, sarà possibile accedere al valore del check. AzioneSelElemento: Sequeza di istruzioni BC o chiamata ad una subroutine. Non è possibile inserire in tale parametro le istruzioni 'GOTO' mentre è consentito inserire una o più operazioni semplici (Assegnamenti) utilizzando il carattere ':' come separatore fra istruzioni.
ALTEZZARIGA
Consente di definire l'altezza del singolo elemento dell ListBox.
RIGHEDESCRIZIONE
Se viene prevista la descrizione del singolo elemento (sottoparametro VARDESCRIZIONE), il parametro RIGHEDESCRIZIONE indica lo spazio che questa deve occupare all'interno di ogni elemento della ListBox. La dimensione di ogni elemento sarà data da: Riga del titolo + Righe descrizione. Se non indicato, l'ambiente assegnerà il valore 2. NumeroRigheDescrizione: Può essere una costante o una variabile di tipo intero.
EXPANDER
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. Le Attached Property di un oggetto inserito all'interno di un pannello definiscono le modalità di visualizzazione dell'oggetto nel pannello e definiscono il comportamento da adottare quando sono modificate a run-time le dimensioni della videata (conseguentemente le dimensioni del pannello contenitore, conseguentemente quelle del controllo). Se l'oggetto viene definito all'interno di un pannello contenitore di tipo Grid è OBBLIGATORIO definire le sue Attached Property; se l'oggetto viene definito all'interno di un pannello di tipo Expander/Stack/Dock NON E' OBBLIGATORIO definire le sue Attached Property. Esempi ListBox definizione esplicita ListBox definizione con struttura dinamica
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LINKTO
Permette di creare un legame tra due controlli esistenti all'interno della stessa videata.
FUNZIONI
Permette di abilitare una serie di funzionalità e la loro modalità di fruizione
Metodi
| Metodo | Descrizione | SMP |
|---|---|---|
| Get_OggettoCorrente |