Navigation:  I Viewer: esposizione dei dati > Il Viewer Grid > Le Property di una Grid > Esempi di Grid Property > Le value list

Una value list è un controllo grafico che permette all'utente di selezionare un valore da una lista. Essa è molto simile ad una drop-down list, ma essa si compone di valori inseriti manualmente e non estratti da tabelle del Model sottostante. In un Viewer di tipo Grid è possibile associare value list alle celle di una colonna mediante opportune Grid e Band Property.

 

 

La Grid Property ValueLists consente di accedere ad un editor dedicato alla definizione di collezioni di value list da associare alle celle di una Grid. Tale editor si compone di due riquadri:

✓ Members, contenente l'elenco delle value list disponibili;

✓ Properties, esponente gli aspetti definitori di ogni singola value list.

I tasti Add e Remove, sotto il riquadro Members, consentono di aggiungere o rimuovere value list nell'elenco sovrastante.

 

I principali aspetti definitori di una value list, configurabili dal riquadro Properties, sono:

✓ Key, identificativo della value list corrente;

✓Appearance, classe di proprietà grafiche con cui configurare l’aspetto della value list;

✓ValueListItems, proprietà con cui accedere ad un editor dedicato alla definizione della collezione di elementi (item), componenti la value-list corrente.

 

L'editor per la configurazione degli item di una value list si compone di due riquadri:

✓ Members, contenente l'elenco degli item disponibili;

✓ Properties, esponente gli aspetti definitori di ogni singolo item.

I tasti Add e Remove, sotto il riquadro Members, consentono di aggiungere o rimuovere item nell'elenco sovrastante.

 

I principali aspetti definitori di un item, configurabili dal riquadro Properties, sono:

✓ Key, identificativo dell'item corrente;

✓ Appearance, classe di proprietà grafiche con cui configurare l’aspetto della item;

✓ DataValue, valore opportunamente tipizzato da associare all'item corrente;

✓ DisplayText, eventuale testo da visualizzare in alternativa al valore associato all'item corrente.

 

 

Le principali proprietà con cui configurare l'aspetto grafico di una value list, disponibili nel corrispondente riquadro Properties, sono:

✓ DisplayStyle, stile di visualizzazione degli item componenti la lista.

✓ SortStyle, eventuale ordinamento da apploiccare agli item della lista.

 

La proprietà DisplayStyle può assumere i valori:

✓ DataValue visualizza il solo DataValue di ogni item;

✓ DataValueAndPicture mostra DataValue e l’eventuale Image associati ad un item;

✓ DisplayText espone il solo DisplayText di ogni item;

✓ DisplayTextAndPicture mostra il DisplayText e l’eventuale Image associati ad un item;

✓ Picture visualizza solamente l’Image associata ai singoli item;

✓ Default, espone sempre DisplayText e Image.

 

 

La proprietà SortStyle può assumere i valori:

✓ None visualizza l’ordine originario di inserimento degli item;

✓ Ascending ordina gli item in ordine alfabetico rispetto al DisplayText;

✓ Descending ordina gli item in ordine alfabetico inverso rispetto al DisplayText;

✓ AscendingByValue ordina gli item in ordine alfabetico rispetto al DataValue;

✓ DescendingByValue ordina gli item in ordine alfabetico inverso rispetto al DataValue.

 

Per visualizzare una value list su una colonna occorre assicurarsi che:

✓ l’oggetto del Model associato alla Grid corrente sia in EditMode Simple o Full;

✓ la Band Property AllowUpdate (classe Override) sia impostata a True;

✓ la Column Property CellActivation sia impostata a AllowEdit.

Infine, per associare una value list alle celle di una particolare colonna, è necessario valorizzare la Column Property ValueList. Essa permette di selezionare un qualunque elemento della collezione di value list corrente, mediante l'opportuna Key.