Mit <RadioButtonGroup>-Controls können Sie eine Gruppe von Radio-Buttons erzeugen, die in einer einzigen Zelle enthalten sind. Benutzer können eine Auswahl aus mehreren vordefinierten Optionen treffen, bei der immer nur eine Option aktiv sein kann. Sie eignen sich insbesondere für Entscheidungen, bei denen sich die Auswahlmöglichkeiten gegenseitig ausschließen, wie etwa die Auswahl einer Zahlungsart oder eines Prioritätslevels.
Hinweise zur Verwendung
Ein <RadioButtonGroup>-Control wird mit dem Element <RadioButtonGroup> erzeugt. Das Element kann nur im Layout einer Detail Component oder einer Form Component verwendet werden.
<RadioButtonGroup>
...
</RadioButtonGroup>
Das Element <RadioButtonGroup> kann folgendes Element enthalten:
-
<RadioButtonOption>
<RadioButtonGroup>-Controls können in allen verfügbaren Layouttypen verwendet werden. Weitere Informationen finden Sie unter Layouts.
Attribute
Hinweis:
Es gibt eine Reihe von Standardattributen, die für alle Controls festgelegt werden können. Weitere Informationen zu den Standardattributen finden Sie unter Standardattribute.
Zusätzlich zu den Standardattributen können Sie das folgende Attribut für <RadioButtonGroup>-Controls definieren:
|
Attribut |
Beschreibung |
|---|---|
|
|
Erforderlich Technischer Wert, der weiterverarbeitet werden soll.
Mögliche Werte: Beliebige Zeichenkette |
Element <RadioButtonOption>
Kindelement von <RadioButtonGroup>. Definiert die einzelnen Optionen für die Radio-Button-Gruppe.
Sie können folgende Attribute für das Element <RadioButtonOption> definieren:
|
Attribut |
Beschreibung |
|---|---|
|
|
Erforderlich Technischer Wert, der weiterverarbeitet werden soll.
Mögliche Werte: Beliebige Zeichenkette |
|
|
Beschriftung des Radio-Buttons.
Mögliche Werte: Beliebige Zeichenkette |
Actions
Für <RadioButtonGroup>-Controls steht Ihnen folgende Action zur Verfügung. Weitere Informationen zu Actions finden Sie unter Actions.
<SelectAction>
Sie können die Action Select über das Element <SelectAction/> innerhalb von <RadioButtonGroup> einfügen. Die Action wird ausgelöst, sobald der Benutzer den Radio-Button auswählt.
Hinweis:
Sie müssen das Element <SelectAction> vor dem gewünschten Layouttyp (BoxLayout, FlowLayout, GridLayout, ResponsiveLayout, TabLayout) einfügen.
Die Aktion Auswählen wird über das Element <SelectAction/> innerhalb von <RadioButtonGroup> erzeugt und ausgelöst, sobald dieser ausgewählt wurde.
Beispiel