Die XdevComboBox ist eine Kombination aus Eingabefeld, Button und Dropdown-Liste, aus der Anwender einen Wert auswählen können. Die Dropdown-Liste enthält meistens die Werte einer Spalte einer Datenbanktabelle.
Das Eingabefeld einer XdevComboBox ist standardmäßig editierbar. Durch jede Eingabe werden die Einträge der Dropdown-Liste automatisch neu gefiltert. Der Selektierte Eintrag wird in der XdevComboBox angezeit. Die XdevComboBox ist eine Formular-Komponente und kann via XdevFieldGroup persistiert werden.
Wichtigste Properties:
Wichtigste Properties:
Wichtige Properies:
- Required - N.
- RequiredError - N.
- Auto query data -
- PageLenght -
- ScrollToSelectedItem -
- TextInputAllowed -
- FilteringMode -
- ItemCaptionFromAnnotation - Zeigt in der Dropdown-Liste die Attribute an, die im Entity Editor bei Settings > Entitycaption definiert wurden, z.B. {%company}, {%carmodels}, {%price}.
- ItemCaptionValue - Zeigt in der Dropdown-Liste die hier definierten Attribute an. Die globale Einstellungen im Entity Editor bei Settings > Entitycaption wird dadurch überschrieben.
- Entity -
- Property -
- Data -
- Master component -
- Connected form -
Wichtige Events:
valueChange - Wird ausgelöst, wenn die Selektierung verändert wurde.
Databinding:
- Entity - Kann mit einem Entity verknüpft werden.
Examples:
Datum zuweisen - Weist dem XdevInlineDateField ein Datum zu. Dies löst ein valueChange Event aus.
// Creates a date 1979-7-5 Date dateOfBirth = new Date(79,6,5); // Sets the date to the inlineDateField inlineDateField.setValue(dateOfBirth);
Datum auslesen
Date date = inlineDateField.getValue();
Selektierung zurücksetzen - Setzt die Selektierung auf den Ausgangszustand. Dies löst ein valueChange Event aus.
inlineDateField.clear();
Fokus setzen - Weist dem XdevInlineDateField den Focus zu. Dies kann ggf. ein focus Event auslösen.
inlineDateField.focus();
Hinweis:
- Date Methoden deprecated - Zahlreiche Methoden der Klasse Date sind als deprecated gekennzeichnet. Da Vaadin unterstützt aktuell jedoch nur die Klasse Date.
Alle XdevComboBox Methoden
XdevComboBox > Properties > FilteringMode > null führt zu Fehler.