XdevComboBox

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.  

Open

Wichtige Properties:

• ReadOnly 

Wichtige Events:

Databinding:

• Daten-Container (Model) 

  • XdevBeanItemContainer - Standard Daten-Container. Die Zuweisung erfolgt mit der Methode setContainerDataSource.

    // Generates a new XdevBeanItemContainer 'productList' XdevBeanItemContainer<Product> productList = new XdevBeanItemContainer<Product>(Product.class);   // Sets the XdevBeanItemContainer comboBox.setContainerDataSource(productList);

  • XdevLazyEntityContainer - Wird ausschließlich von RapidClipse verwendet, wenn die Property Entity > Auto quer data selektiert ist.

Examples:

• Einträge hinzufügen - Weist dem XdevComboBox manuell Einträge hinzu.

  comboBox.addItem("Eintrag 1"); comboBox.addItem("Eintrag 2");

  Direkte Zuweisung mehrerer Einträge.

  listSelect.addItems("Eintrag 1", "Eintrag 2", "Eintrag 3", "Eintrag 4");

• Selektiertes Objekt - Liefert das selektierte Objekt zurück (Entity) - Beispiel mit Category Entity

  Category Category = comboBox.getSelectedItem();

  oder

  Category Category = (Category)comboBox.getValue();

• Elemente entfernen - Entfernt alle Elemente aus der XdevComboBox

  comboBox.removeAllItems();

• Element selektieren - Automatisches Selektieren eines Eintrages - Beispiel: erster Eintrag.

  Collection<?> itemIds = comboBox.getItemIds(); comboBox.setValue(((List<Category>)itemIds).get(0));

• Selektierung zurücksetzen - Setzt die Selektierung auf den Ausgangszustand. Dies löst ein valueChange Event aus.

  comboBox.clear();

• Beliebigen Wert des selektierten Objektes auslesen - Beispiel: "Categoryname"

  String categoryName = comboBox.getSelectedItem().getBean().getCategoryname();

• XdevComboBox Daten auslesen - Erzeugt einen neuen XdevBeanContainer productContainer vom Typ Product und weist diesen mit der Methode getContainerDataSource den XdevBeanContainer der XdevComboBox zu.

  XdevBeanContainer<Product> productContainer = comboBox.getContainerDataSource();

Alle XdevComboBox Methoden 

Hinweis:

• XdevComboBox > Properties > FilteringMode > null führt zu Fehler.