ListBox

32.3

L'elemento ListBox, consente di creare una Lista, all'interno di una videata. 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.

Elementi

Elemento	Tipo	MinOccurs	MaxOccurs
DynStructItem	vuoto	0	1
Items	ListBoxItems	0	1
Validation	vuoto	0	1

Attributi

Attributo	Tipo	Default		Pattern	Versione
Action	bcAction			[.*]|D*
CurrentPage	bcBinding			{.*}
Customizable	boolean	true
DefaultAction	bcAction			[.*]|D*
DefaultPage	bcIntVariable			[.*]|-?d+
DescriptionRowsNumber	int
Disabled	bcAction			[.*]|D*
Extension	enumExtension	None
Name	string
OnSelectItemAction	bcAction			[.*]|D*
Resizable	boolean	true
Expander.Horizontal	boolean
Expander.Vertical	boolean
Expander.InfoPosition	int
Grid.Col	int
Grid.Row	int
Grid.RowDyn	int
Grid.ColDyn	int
Grid.RowSpan	int
Grid.ColSpan	int
Schema.Horizontal	boolean
Schema.Vertical	boolean
Schema.Extended	boolean
Schema.Section	enumSchemaSection
Stack.Horizontal	boolean
Stack.Vertical	boolean
Stack.Extended	boolean
Extension.InsertBefore	string
Extension.InsertAfter	string
LinkTo.Name	string
LinkTo.Primary	boolean
LinkTo.Type	enumLinkTo
Position.Y	double
Position.X	double
Height	double
Width	double
TabIndex.X	int
TabIndex.Y	int

Action

[.*]|D*

Definisce l'azione da eseguire quando uno degli elementi della ListBox viene premuto con il mouse.

CurrentPage

{.*}

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 Action.

Customizable

true

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

DefaultAction

[.*]|D*

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.

DefaultPage

[.*]|-?d+

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).

DescriptionRowsNumber

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.

Disabled

[.*]|D*

Attributo che consente di disabilitare la ListBox.

Extension

None

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
None	None
Override	Override
New	New
Remove	Remove

Name

Obbligatorio

Definisce l' identificativo dell'elemento ListBox.

OnSelectItemAction

[.*]|D*

Definisce l'azione da eseguire a seguito della spunta di un dato elemento.
L'azione verrà richiamata al termine della valorizzazione interna della struttura.

Resizable

true

Attributo che specifica in che modo si vuole ridimensionare la griglia.

Expander.Horizontal

L'oggetto va ad occupare tutto lo spazio dell'Expader in orizzontale

Expander.Vertical

L'oggetto va ad occupare tutto lo spazio dell'Expader in verticale

Expander.InfoPosition

L'oggetto farà parte della banda informativa dell'Expander, alla data posizione indicata nella proprietà. La banda informativa dell'expander e visibile esclusivamente a controllo collassato.

Grid.Col

Indica la colonna relativa a cui il controllo viene associato. La posizione iniziale del controllo parte dalla sua colonna relativa. Il POS è quindi relativo alla sua colonna/riga e non alla videata.

Grid.Row

Indica la riga relativa a cui il controllo viene associato. La posizione iniziale del controllo parte dalla sua riga relativa. Il POS è quindi relativo alla sua colonna/riga e non alla videata.

Grid.RowDyn

L'oggetto segue dinamicamente la riga, quindi nel momento in cui la riga, a cui fa riferimento, si ridimensiona, il controllo segue il medesimo comportamento

Grid.ColDyn

L'oggetto segue dinamicamente la colonna, quindi nel momento in cui la colonna, a cui fa riferimento, si ridimensiona, il controllo segue il medesimo comportamento

Grid.RowSpan

Indica il numero di righe che l'oggetto deve occupare all'interno del GridPanel padre

Grid.ColSpan

Indica il numero di colonne che l'oggetto deve occupare all'interno del GridPanel padre

Schema.Horizontal

L'oggetto va ad occupare tutto lo spazio della sezione dello schema in orizzontale

Schema.Vertical

L'oggetto va ad occupare tutto lo spazio della sezione dello schema in verticale

Schema.Extended

L'oggetto con la proprietà Extended si autodimensiona a runtime, per riempire tutto lo spazio 'Libero' all'interno dello SchemaPanel. Se più oggetti hanno l'attachedproperty Extended, lo spazio viene diviso in percentuale su tutti gli oggetti. Il suo utilizzo è legato ad un dimensionamento della videata (es. a tutto schermo).

Schema.Section

Indica la sezione dove l'oggetto viene posizionato all'interno dello SchemaPanel: List, View, FactBox

Stack.Horizontal

Indica che l'oggetto deve occupare tutto lo spazio dello StackPanel in orizzonta (da utilizzare solo con orientamento verticale)

Stack.Vertical

Indica che l'oggetto deve occupare tutto lo spazio dello StackPanel in verticale (da utilizzare solo con orientamento orizzontale)

Stack.Extended

L'oggetto con la proprietà Extended si autodimensiona a runtime, per riempire tutto lo spazio 'Libero' all'interno dello StackPanel. Se più oggetti hanno l'attachedproperty Extended, lo spazio viene diviso in percentuale su tutti gli oggetti. Il suo utilizzo è legato ad un dimensionamento della videata (es. a tutto schermo) o la riduzione di qualche controllo al suo interno (es. ExpanderPanel)

Extension.InsertBefore

All'interno di un pannello di tipo Section, è possibile specificare il nome del controllo, della videata standard, prima del quale si vuole inserire il proprio controllo personalizzato.

Extension.InsertAfter

All'interno di un pannello di tipo Section, è possibile specificare il nome del controllo, della videata standard, dopo del quale si vuole inserire il proprio controllo personalizzato.

LinkTo.Name

Indica il Name del controllo al quale linkare quello corrente.
In presenza di layout dinamici Accordion/section, il linkto, oltre a legare lo stato e alcune azioni specifiche, forzerà la posizione affiancata a tutti i controlli linkati.

LinkTo.Primary

Indica che il controllo linkato è primario.
Ad oggi la funzione di primario, permetterà di prendere il testo dal controllo, e visualizzarlo come elemento identificativo all'interno della videata di personalizzazione della finestra corrente.

LinkTo.Type

Indica il tipo di legame tra i controlli (per maggiori informazioni consultare gli enumerati).

Position.Y

Posizione, in coordinate righe, del controllo

Position.X

Posizione, in coordinate colonne, del controllo

Height

Dimensione in altezza del controllo (altezza identificata dal numero di righe)

Width

Dimensione in lunghezza del controllo (altezza identificata dal numero di colonne)

TabIndex.X

Identifica l'ordine del reticolo nel senso orizzontale (TAB/Freccia DX)

TabIndex.Y

Identifica l'ordine del reticolo nel senso verticale (Freccia Su/Giù)

Metodi

Metodo	Descrizione
GetCurrentObject