XdevCheckBox

Owned by RapidClipse Team
Last updated: Feb 16, 2017 by Johannes M
1 min read

Die XdevCheckBox ist eine Auswahl-Komponente, die nur die zwei Zustände selektiert und nicht selektiert abbilden kann. Die Beschriftung (Caption) wird direkt neben der Checkbox angezeigt.  

Die XdevOptionGroup ist eine Formular-Komponente und kann via XdevFieldGroup persistiert werden. Dazu müssen Sie die XdevCheckBox bei der XdevFieldGroup > Field mapping > Property mit einem Attribut vom Typ Boolean verknüpfen.  

 

Wichtige Properties:

  • Caption - Zeigt den Text als Beschriftung an.

  • Required - Die Formular-Komponente wird als Pflichtfeld definiert, das ausgefüllt, selektiert oder bei der eine Auswahl vorgenommen werden muss.

  • RequiredError - Fehlermeldung die angezeigt wird, wenn die als Pflichtfeld definierte Formular-Komponente nicht ausgefüllt, selektiert oder wenn keine Auswahl vorgenommen wurde.

  • Shortcut

  • TabIndex - Definiert die Reihenfolge im Tab-Index. Der Tab-Index definiert die Reihenfolge mehrerer UI-Komponenten, die durch Drücken der Tab Taste nacheinander selektiert werden.

Wichtige Events:

  • valueChange - Wird ausgelöst, wenn der Inhalt verändert wurde, u.a. durch Hinzufügen oder Löschen von Zeichen, jedoch erst wenn die UI-Komponente den Fokus verliert.


Databinding:


Daten-Container (Model) - Property

    • Ein Property kann implizit gesetzt werden mit setValue

      // Sets the Property

checkBox.setValue(true);


    • oder indem ein Property eines Items als Model gesetzt wird. Die Zuweisung erfolgt dabei mit der Methode setPropertyDataSource.

      // Gets a property from the SeletcedItem of a Table with "Product" Entities
Property<?> itemProperty = this.table.getSelectedItem().getItemProperty("discontinued");

// Sets the Property
checkBox.setPropertyDataSource(itemProperty);


Examples:

  • Wert auslesen

    Boolean value = checkBox.getValue();

  • Wert setzen - Bei "true" ist der Haken der Checkbox gesetzt

    checkBox.setValue(true);

  • Checkbox zurücksetzen

    checkBox.clear();

  • Fokus zuweisen - Weist dem XdevInlineDateField den Focus zu. Dies kann ggf. ein focus Event auslösen.

    checkBox.focus();
Alle XdevCheckBox Methoden 

XDEV Software Corp. - One Embarcadero Center, San Francisco, CA 94111, US
Copyright © 2015. XDEV Software Corp. All rights reserved.