OGGETTO CASELLA A DISCESA

Last updated on

Descrizione

Inserendo una casella a discesa, si inserisce un oggetto che permette di visualizzare una lista a tendina;
le voci elencate all’interno della lista sono specificate all’interno della proprietà “Querylista“.

FD_ogg_Casella a discesa

Proprietà specifiche

Così come per l’oggetto “Lista”, mettiamo in evidenza tra le varie proprietà di questo oggetto, la proprietà “Querylista”.
Da notare che la query può restituire uno o due elementi. Se ne restituisce due, il secondo contiene il valore che verrà restituito dal metodo GetValue lato server, e sarà anche possibile assegnare il valore visualizzato nella tendina utilizzando il metodo SetValue e specificando il valore associato.

Eventi specifici

  • EventoCambia
    evento attivato al cambiamento del valore del campo.Può essere utilizzato per
    – assegnare altri campi in base al valore inserito nel campo
    – verificare la validità del valore inserito dando eventualmente un messaggio all’utente.

per maggiori informazioni sugli eventi leggi qui.

Proprietà utilizzabili da codice lato Server (VB.NET/C#)

  • BackColor: colore di sfondo, di tipo System.Drawing.Color. 
  • Enabled: se viene settato False, il campo non risulta più modificabile (la descrizione del nome diventa di colore grigio). 
  • ForeColor: colore del testo, di tipo System.Drawing.Color.
  • Style(“<elemento css>”): consente di leggere e modificare il valore dell’elemento dello stile CSS specificato come parametro.
  • ToolTip: testo di aiuto da visualizzare al passaggio del mouse sull’oggetto.
  • Value: se True restituisce il testo contenuto nell’oggetto.
  • Visible: se True il campo lo si rende visibile nel form, in caso contrario lo si assegna con False.

Metodi utilizzabili da codice lato Server (VB.NET/C#)

  • GetItems() As DBArray : restituisce un DBArray contenente tutti gli elementi della lista. 
  • SetItems(items As DBArray) : assegna alla lista gli elementi contenuti nel DBArray passato come argomento. Ogni elemento può essere una stringa o un oggetto DBArray di due elementi, il primo essendo il codice che verrà restituito dal metodo GetValue lato server, e il secondo il testo che verrà mostrato nella tendina.
  • GetValue() : restituisce il codice associato al testo selezionato, nel caso in cui gli elementi definiti da QueryLista o tramite SetItems siano coppie codice-testo
  • SetValue(code as object) : assegna il valore tramite il relativo codice, nel caso in cui gli elementi definiti da QueryLista o tramite SetItems siano coppie codice-testo

Metodi utilizzabili da codice lato Client (Javascript)

  • show(): visualizza l’oggetto.
  • hide(): nasconde l’oggetto.
  • enable(): abilita l’oggetto.
  • disable(): disabilita l’oggetto.
  • setValue(<value>): assegna il valore <value> all’oggetto. NOTA: a differenza dell’omonimo metodo della versione lato server, restituisce il valore visualizzato nella tendina e non l’eventuale codice nel caso in cui gli elementi definiti da QueryLista o tramite SetItems siano coppie codice-testo.
  • getValue(): restituisce il valore dell’oggetto. NOTA: a differenza dell’omonimo metodo della versione lato server, restituisce il valore visualizzato nella tendina e non l’eventuale codice nel caso in cui gli elementi definiti da QueryLista o tramite SetItems siano coppie codice-testo.
  • setLabel(<value>): assegna l’etichetta dell’oggetto (solo versione mobile). NOTA: a differenza dell’omonimo metodo della versione lato server, restituisce il valore visualizzato nella tendina e non il codice