XdevOptionGroup

Die XdevOptionGroup ist eine Auswahl-Komponente bestehend aus einer Radiobutton-Gruppe, welche nur die Selektierung eines einzelnen Wertes zulässt. Durch die Einstellung MultiSelect wird die XdevOptionGroup zu einer Checkbox-Liste, welche auch die Selektierung mehrerer oder aller Werte zulässt.  

Die XdevOptionGroup ist eine Formular-Komponente und kann via XdevFieldGroup persistiert werden.  

• Auto query data - Führt automatisch eine Datenbankabfrage durch und füllt das mit der UI-Komponente verknüpfte Entity. Daten, die nicht angezeigt werden können, werden lazy nachgeladen (Lazy-Loading). Als Daten-Container wird der XdevLazyEntityContainer verwendet.

• Connected form - Verknüpft die UI-Komponente (Master) mit der angegebenen XdevFieldGroup (Detail). 

• Entity - Verknüpft das zugewiesene Entity mit der UI-Komponente.

  • Properties - Zeigt in der UI-Komponente die Attribute des verknüpften Entites an, die hier angegeben werden, z.B. {%company}. Es können auch mehrere Attribute angezeigt werden, z.B. {%company}, {%carmodels}, {%price}. Dadurch werden die ggf. gesetzten Einstellung im Entity Editor bei Settings > Entity caption sowie bei Properties > ItemCaptionValue überschrieben.

  • Data - Verwendet anstelle der Standard-Abfragestrategie Auto query data die Abfrage-Methode findAll oder eine benutzerdefinierte Abfrage-Methode. findAll überträgt das gesamte Abfrageergebnis und verwendet als Daten-Container den XdevBeanItemContainer. Lazy-Loading wird nicht unterstützt.

  • Hierarchy - Nur bei XdevTree.

• ItemCaptionFromAnnotation - Zeigt in der UI-Komponente die Attribute des verknüpften Entites an, die im Entity Editor bei Settings > Entity caption global definiert wurden, z.B. {%company}, {%carmodels}, {%price}.

• ItemCaptionValue - Zeigt in der UI-Komponente die Attribute des verknüpften Entites an, die hier angegeben werden, z.B. {%company}. Es können auch mehrere Attribute angezeigt werden, z.B. {%company}, {%carmodels}, {%price}. Dadurch wird die ggf. gesetzte, globale Einstellung im Entity Editor bei Settings > Entity caption überschrieben. 

• Master component - Mit der UI-Komponente verknüpfte Master-Komponente.

• ReadOnly 

• Shortcut

• 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 listSelect.setContainerDataSource(productList);

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

• Selektierung auslesen - Liefert das selektierte Objekt zurück (Entity) - Beispiel mit "Product"-Entity

  BeanItem<Product> selectedItem = this.optionGroup.getSelectedItem(); Product product = selectedItem.getBean();

  oder - Liefert eine Liste aller selektierten Elemente zurück

  List<BeanItem<Product>> selectedItems = this.optionGroup.getSelectedItems();

   

• Selektierung setzen

  Object idByIndex = this.optionGroup.getBeanContainerDataSource().getIdByIndex(0); optionGroup.setValue(idByIndex);

   

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

  optionGroup.clear();

• Einzelne Items enablen und disablen mit setItemEnabled()

  Object firstItemId = this.optionGroup.getBeanContainerDataSource().firstItemId(); // disable item optionGroup.setItemEnabled(firstItemId, false);
  // enable item optionGroup.setItemEnabled(firstItemId, true);

• Fokus setzen- Weist der XdevOptionGroup den Focus zu. Dies kann ggf. ein focus Event auslösen.

  optionGroup.focus();