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

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)

Selezione a discesa¶

Proprietà¶

Metodi¶

Aggiorna¶

Eventi¶

Selezione modificata¶