Class "guigen :: TextField"

Defined in package : guigen

DataWidget per l'immissione di testo.

Annotations

Super and Sub Types

Direct Attributes

Inherited Attributes

Inherited References

Attribute ecore :: EInt fieldLength

Dimensione in caratteri dell area visibile del campo.

PropertyDescription
typeecore :: EInt
changeabletrue
defaultValueLiteral15
derivedfalse
iDfalse
lowerBound0
namefieldLength
orderedtrue
transientfalse
uniquetrue
unsettablefalse
upperBound1
volatilefalse

Attribute ecore :: EInt fieldMaxLength

Numero massimo di caratteri digitabili

PropertyDescription
typeecore :: EInt
changeabletrue
defaultValueLiteralnull
derivedfalse
iDfalse
lowerBound0
namefieldMaxLength
orderedtrue
transientfalse
uniquetrue
unsettablefalse
upperBound1
volatilefalse

Annotation logicpkg

KeyValue
pkgui.widgets

Annotation uiwidgetdoc

KeyValue
descriptionE' il classico widget di immissione di dati testuali a riga singola. Il widget completo prevede una label ed il campo di immissione associato. La label può essere, in casi particolari, vuota. Il TextField può essere utilizzato all'interno di:
  • WidgetsPanel, con layout Verticale, Orizzontale, Griglia
Prevede due modalità di funzionamento, una standard ed una ricca.

modalità standard

Il funzionamento di base del TextField prevede:
  • la possibilità di specificare il numero massimo di caratteri accettabili
  • la possibilità di specificare la dimensione massima dell'area editabile (che è utilizzata in modi differenti a seconda della cartuccia/skin)
  • la possibilità di effettuare, al momento del submit della form, la validazione dell'input immesso a seconda del tipo di dato associato al campo e di alcuni ulteriori specifiche
  • la possibilità di essere disabilitato a comando
  • la possibilità di essere reso invisibile a comando
  • la possibilità di essere disabilitato/invisibile a fronte di regole associate al profilo dell'utente collegato
  • la visualizzazione di un marcatore di errore in prossimità della label, in caso di fallita validazione

modalità ricca

La modalità ricca prevede di default i seguenti comportamenti aggiuntivi:
  • verifiche client side al momento della digitazione di aderenza dei caratteri immessi al tipo di dato previsto (es. solo caratteri numerici per tipi numerici)
  • verifiche client side al momento della digitazione di rispetto della dimensione massima del dato
  • tooltip al passaggio del cursore sulla label del widget
Inoltre è possibile, se esplicitamente modellato, associare al TextField la funzionalità di suggestion che consiste nel fornire, man mano che si digitano i caratteri nel campo di testo, una lista di voci che corrispondono nella loro parte iniziale alla stringa di caratteri immessa fino a quel momento (la logica di costruzione progressiva della lista di suggerimenti è a carico dello sviluppatore).
event-key-pressed

L'evento KeyPressed, utilizzabile solo in modalità ricca, permette di ottenere la funzione di suggestion

generated on 5-set-2016 at 16.27.37 by metamodeldoc