Selezione a discesa

BrowseName: ComboBox
SuperType: Elemento (Item)
Percorso nella TypeView: Tipi > UI > Controlli dati > Selezione a discesa

Selezione a discesa i cui elementi sono ricavati da un modello di nodi del progetto o da una o più tabelle di un database.

Come si presenta

../../../_images/ref_ComboBox_ex.gif

Applicazioni

Usato tipicamente per selezionare un oggetto di interesse di cui visualizzare/caricare i dati, per esempio un motore di cui si vogliono visualizzare i dati in una tabella affiancata, oppure una ricetta da caricare sul PLC.

Configurare l’oggetto

Impostare la sorgente dei dati

Nella proprietà Modello impostare un collegamento dinamico con il nodo padre dei nodi di progetto di interesse o un collegamento dinamico con un oggetto di tipo database:

  • Se si imposta un collegamento con un nodo padre, i dati visualizzabili sono i valori degli attributi o delle proprietà di tutti i nodi direttamente figli e del tipo indicato nella proprietà ItemKind. Tipicamente ci si riferisce a una collezione di oggetti con modello informativo uguale o simile… note:: Q Studio imposta automaticamente la proprietà ItemKind con il tipo di oggetto/variabile riconosciuto tra i nodi figli. Per esempio, se il modello è basato su un nodo cartella che contiene diverse istanze di un tipo di oggetto Motor, ItemKind viene automaticamente impostata con il riferimento al tipo Motor. In questo caso i valori visualizzabili nelle diverse colonne sono i valori degli attributi o delle proprietà delle diverse istanze (Motor1, Motor2, Motor3…).

  • Se si imposta un collegamento con un oggetto di tipo database, i dati visualizzabili sono i valori contenuti nelle sue tabelle.

Impostare i dati da visualizzare in colonna

Impostare la proprietà Percorso del valore visualizzato:

Se la sorgente dei dati è…

Allora nella finestra dei collegamenti dinamici…

un modello di nodi

in Alias > {Item}(object path) è disponibile l’alias dell’oggetto impostato in ItemKind. Selezionare l’attributo o la proprietà desiderata, poi fare clic su Seleziona.

un oggetto di tipo database

in Alias > {Item}(object path) > PointedNode scrivere il nome della colonna desiderata della tabella del database, poi fare clic su Seleziona.

Impostare l’ordinamento dei dati

A seconda della sorgente dati, di default gli elementi sono disposti nello stesso ordine con cui sono disposti i nodi nel modello o le righe nelle tabelle del database.

Tramite la proprietà Ordina per è possibile ordinare gli elementi indipendentemente dal contenuto visualizzato a runtime nella lista. Se non si ha questa necessità, impostare Ordina per con lo stesso attributo/proprietà o colonna da cui sono ricavati gli elementi.

Visualizzare i dati in tempo reale a runtime

Quando i dati sono ricavati da tabelle di un database, per visualizzare dati aggiornati in tempo reale configurare l’invocazione del metodo Aggiorna esposto dall’oggetto Selezione a discesa. Tipicamente si associa questo metodo a un evento di un oggetto Pulsante.

Proprietà

Nome

BrowseName

DataType

Descrizione

Testo

Text

LocalizedText

(Solo con Modalità = Modificabile) Testo dell’elemento scritto/selezionato. Può essere usato per realizzare logiche personalizzate (per esempio creare nuovi nodi).

Modello

Model

NodeId

Riferimento al modello informativo o al database da cui ricavare i dati

Valore selezionato

SelectedValue

BaseDataType

Valore della proprietà impostata in Percorso del valore selezionato quando viene selezionato un elemento a runtime.

Item selezionato

SelectedItem

NodeId

Elemento selezionato quando l’oggetto viene inizializzato a runtime (se vuota viene inizializzato senza selezioni). Dopo l’inizializzazione, questa proprietà espone il nodo corrispondente all’elemento selezionato (l’accesso alla proprietà è sia in lettura che scrittura quando i dati sono ricavati da nodi di progetto, in sola lettura quando sono ricavati da un database).

Item UI selezionato

UISelectedItem

NodeId

Valore UI selezionato

UISelectedValue

BaseDataType

Permetti deselezione

AllowDeselection

Boolean

Percorso del valore visualizzato

DisplayValuePath

LocalizedText

Attributo/proprietà dei nodi o colonna di una tabella di un database di cui visualizzare il valore nella lista. Quando non è valorizzata, se il modello è basato su nodi viene visualizzato il BrowseName dei nodi, se il modello è basato su database viene visualizzato il valore della prima cella di ogni riga, a meno di query che filtrano ulteriormente i valori.

Percorso del valore selezionato

SelectedValuePath

BaseDataType

Proprietà con cui valorizzare la proprietà Valore selezionato a runtime quando si seleziona un elemento.

Query

Query

String

Query SQL standard per filtrare i dati di interesse. Può essere usata sia per filtrare dati di un database che per filtrare dati ricavati da un modello basato su nodi. Nel caso di modello basato su nodi, è obbligatoria la parte SELECT * FROM Model, seguita dalla clausola WHERE con cui indicare le condizioni di ricerca - es.: SELECT * FROM Model WHERE Speed > 40.

Modalità

Mode

ComboBoxModeEnum

Modalità di selezione degli elementi. Normale = selezione tramite clic; Normale con ricerca testuale = selezione tramite clic o tramite digitazione completa di un elemento esistente; Modificabile = selezione tramite clic o tramite digitazione completa di un elemento esistente o nuovo.

Famiglia di font

FontFamily

Font

Famiglia di font

Spessore font

FontWeight

FontWeightEnum

Spessore del font

Font corsivo

FontItalic

Boolean

Abilita/disabilita lo stile corsivo per il testo.

Dimensione font

FontSize

Size

Dimensione del font

Colore testo

TextColor

Color

Colore del testo da visualizzare

Direzione ordinamento

SortOrder

SortOrderEnum

Ordinamento predefinito, crescente o decrescente, degli elementi

Ordina per

OrderBy

NodePath

Attributo/proprietà dei nodi o colonna di una tabella in base a cui ordinare gli elementi. Generalmente si imposta lo stesso attributo/proprietà o colonna da cui sono ricavati gli elementi.

Visibilità

Visible

Boolean

Mostra/nasconde la finestra.
(Ereditato da Elemento)
Abilitato

Enabled

Boolean

Abilita/disabilita l’interazione da parte dell’utente (Vero = abilitato, Falso = disabilitato).
(Ereditato da Elemento)
Opacità

Opacity

Float

Livello di opacità (0 = trasparente)
(Ereditato da Elemento)
Margine sinistro

LeftMargin

Size

(Solo se Allineamento orizzontale = Sinistra o Centro o Adatta) Distanza tra il bordo sinistro dell’oggetto e il bordo sinistro del suo contenitore.
(Ereditato da Elemento)
Margine superiore

TopMargin

Size

(Solo se Allineamento verticale = Superiore o Centro o Adatta) Distanza tra il bordo superiore dell’oggetto e il bordo superiore del suo contenitore.
(Ereditato da Elemento)
Margine destro

RightMargin

Size

(Solo se Allineamento orizzontale = Destra o Centro o Adatta) Distanza tra il bordo destro dell’oggetto e il bordo destro del suo contenitore.
(Ereditato da Elemento)
Margine inferiore

BottomMargin

Size

(Solo se Allineamento verticale = Inferiore o Centro o Adatta) Distanza tra il bordo inferiore dell’oggetto e il bordo inferiore del suo contenitore.
(Ereditato da Elemento)
Larghezza

Width

Size

Larghezza della finestra. Può assumere valori maggiori o uguali a zero. Il valore Auto imposta la larghezza uguale alla larghezza del contenuto (in questo caso, in mancanza di contenuto l’oggetto collassa).
(Ereditato da Elemento)
Altezza

Height

Size

Altezza della finestra. Può assumere valori maggiori o uguali a zero. Il valore Auto imposta l’altezza uguale all’altezza del contenuto (in questo caso, in mancanza di contenuto l’oggetto collassa).
(Ereditato da Elemento)
Allineamento orizzontale

HorizontalAlignment

HorizontalAlignment

Allineamento dell’oggetto sull’asse orizzontale. Sinistra = il lato sinistro viene posizionato sul lato sinistro del contenitore, a meno di margine sinistro; Destra = il lato destro viene posizionato sul lato destro del contenitore, a meno di margine destro; Centro = il centro dell’oggetto viene posizionato al centro del contenitore, a meno di margini sinistro e/o destro; Adatta = la larghezza dell’oggetto equivale alla larghezza del contenitore, a meno di margini sinistro e/o destro.
(Ereditato da Elemento)
Allineamento verticale

VerticalAlignment

VerticalAlignment

Allineamento dell’oggetto sull’asse verticale. Superiore = il lato superiore viene posizionato sul lato superiore del contenitore, a meno di margine superiore; Inferiore = il lato inferiore viene posizionato sul lato inferiore del contenitore, a meno di margine inferiore; Centro = il centro dell’oggetto viene posizionato al centro del contenitore, a meno di margini superiore e/o inferiore; Adatta = l’altezza dell’oggetto equivale all’altezza del contenitore, a meno di margini superiore e/o inferiore.
(Ereditato da Elemento)
Rotazione

Rotation

Size

Rotazione dell’oggetto rispetto al suo centro. I valori positivi indicano gradi sessagesimali in senso orario.
(Ereditato da Elemento)

Metodi

Aggiorna

BrowseName: Refresh

Eventi

Selezione modificata

BrowseName: UserSelectionChanged