X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

RadioButton

<RadioButton>-Controls werden verwendet, um eine Gruppe von Buttons zu erzeugen. Der Benutzer kann immer nur einen Radio-Button aus dieser Gruppe gleichzeitig auswählen.


Attribut

Beschreibung

displayName

Beschriftung des Radio-Buttons

  • Übersetzbar

  • Data Binding möglich

Mögliche Werte: Beliebige Zeichenkette

optionValue

Erforderlich. Technischer Wert, der weiterverarbeitet werden soll.

  • Data Binding (String oder Boolean) möglich

Mögliche Werte: Beliebige Zeichenkette

Hinweis:

Es ist möglich, mit Klick auf einen Radio-Button weitere Radio-Buttons zu aktivieren. Dazu muss das Attribut optionValue für alle Radio-Buttons identisch sein, die durch Auswählen eines der Radio-Buttons aktiviert werden sollen.

value

Erforderlich. Radio-Buttons mit gleichem value bilden eine Gruppe, in der jeweils nur ein Radio-Button ausgewählt werden kann.

  • Data Binding (String oder Boolean) erforderlich

Mögliche Werte: Beliebige Zeichenkette

Hinweis:

Standardmäßig sind Radio-Buttons beim Aufrufen der Web App nicht ausgewählt. Damit ein Radio-Button bereits beim Aufrufen der Web App ausgewählt ist, müssen die Werte für optionValue und value identisch sein.

background

Definiert eine Farbe für den Hintergrund des Controls.


  • Diese Einstellung überschreibt die Standardfarbe des Farbschemas!

  • Dieses Attribut funktioniert nicht für die Controls Maps und HtmlDocument!

Mögliche Werte:

  • Hexadezimaler Farbwert, z. B. ff5a00

    Verwenden Sie keine Raute vor dem Farbwert!
    Verwenden Sie keine verkürzte Schreibweise des Farbwerts!


  • Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. A200

enabled

Legt fest, ob der Nutzer mit dem Control interagieren kann.

  • Data Binding (Boolean) möglich

Mögliche Werte: true/false oder Ausdruck für Data Binding

Das Attribut enabled ersetzt das veraltete Attribut disabled. enabled="true" entspricht damit dem veralteten Attribut  disabled="false" .

fontFamily

Legt die Schriftfamilie fest. 

  • Mit diesem Attribut wird die Standardschrift der Web App für dieses Control überschrieben.

  • Wird das Attribut auf einem Element definiert, so wird die Schriftfamilie an die Kindelemente des Elementes vererbt, sofern die Kindelemente das Attribut fontFamily nicht explizit gesetzt haben.

  • Dieses Attribut funktioniert nicht für die Elemente Image, Map und HtmlDocument.

Mögliche Werte:

  • MainFont: hinterlegte Hauptschrift

  • Fontcode aus der Font-Palette, z. B.  Font04

fontSize

Legt die Schriftgröße fest.

  • Mit diesem Attribut wird die Standardschriftgröße der Web App für dieses Control überschrieben.

  • Dieses Attribut funktioniert nicht für die Elemente Image, Map und HtmlDocument.

Mögliche Werte:

  • Beliebige ganze Zahl oder Dezimalzahl mit einem Punkt als Dezimaltrennzeichen, z. B. 20 ; 20.8 ; .9

  • Schriftgröße in Pixel, z. B.  20px

  • Schriftgröße in Punkt, z. B. 18pt

  • Schriftgröße im Vergleich zur Schriftgröße des Elternelements, z. B. .8em  oder  120%

  • Schlüsselwörter: xx-Small , x-small , small , medium , large , x-large , xx-large , smaller , larger

fontStretch

Legt die Breite der einzelnen Schriftzeichen fest.

Mit diesem Attribut wird die Standardbreite der Schriftzeichen für dieses Control überschrieben.

Mögliche Werte:

  • Condensed

  • Expanded

  • ExtraCondensed

  • ExtraExpanded

  • Medium

  • Normal (Standard)

  • SemiCondensed

  • SemiExpanded

  • UltraCondensed

  • UltraExpanded


Dieses Attribut funktioniert nicht für die Elemente Image, Map, Chart und HtmlDocument .

fontStyle

Legt die Neigung der Schrift fest.

Mit diesem Attribut wird die Standardneigung der Schriftzeichen für dieses Control überschrieben.

Mögliche Werte:

  • italic: kursive Schrift

  • normal: normale Schrift (Standard)

  • oblique: schräg gestellter Schriftstil (berechnet)


Dieses Attribut funktioniert nicht für die Elemente Image, Map und HtmlDocument.

fontWeight

Legt die Schriftstärke fest. 

Mit diesem Attribut wird die Standardstärke der Schriftzeichen für dieses Control überschrieben.

Mögliche Werte:

  • Black

  • Bold

  • DemiBold

  • ExtraBlack

  • ExtraBold

  • ExtraLight

  • Heavy

  • Light

  • Medium

  • Normal (Standard)

  • Regular

  • SemiBold

  • Thin

  • UltraBlack

  • UltraBold

  • UltraLight


Dieses Attribut funktioniert nicht für die Elemente Image, Map und HtmlDocument.

foreground

Definiert eine Farbe für den Vordergrund (Texte usw.) des Controls.

  • Diese Einstellung überschreibt die Standardfarbe des Farbschemas!

  • Dieses Attribut funktioniert nicht für die Controls Map und HtmlDocument!


Mögliche Werte:

  • Hexadezimaler Farbwert, z. B. ff5a00

    Verwenden Sie keine Raute vor dem Farbwert!
    Verwenden Sie keine verkürzte Schreibweise des Farbwerts!


  • Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. A200

horizontalAlign

Richtung, in die die Elemente fließen. Reihenfolge der Elemente entspricht ihrer Deklaration.

Mögliche Werte:

  • left (Standard)

  • center

  • right

textOverflow

Gibt an, was passieren soll, wenn das Control voll ist.

Mögliche Werte:

  • ellipsis : Mit ... zeigen, dass der Text nicht zu Ende ist

  • hidden : Text abbrechen, auf ganze Wörter achten

  • wordBreak : innerhalb des Wortes abbrechen

  • allow  (Standard): Text zwischen den Wörtern umbrechen

visible

Legt fest, ob das Control sichtbar ist.

  • Data Binding (Boolean) möglich

Mögliche Werte: true / false oder Zeichenkette für Data Binding

Aktion "Auswählen" innerhalb eines Radio-Buttons

Die Aktion Auswählen wird über das Element <SelectAction/> innerhalb von <RadioButton> erzeugt und ausgelöst, sobald dieser ausgewählt wurde.

Beispiel <RadioButton>

Im folgenden Beispiel ist die Verwendung des <RadioButton>-Tags gezeigt.

XML
<DetailComponent name="ExampleRadioButton" path="ExampleRadioButton" displayName="Example RadioButton" process="exampleProcess.wrf">
		<Properties>
			<Property name="group" type="String"></Property>
		</Properties>
		<FlowLayout>
			<RadioButton optionValue="true" value="#group" displayName="Button 1" />
			<RadioButton optionValue="false" value="#group" displayName="Button 2"/>
		</FlowLayout>
</DetailComponent>


Output-Format des Prozesses

Der im Beispiel genannte Technical Process exampleProcess.wrf generiert folgenden Output:

XML
<?xml version="1.0" encoding="UTF-8"?>
<Ok>
	<group>false</group>
</Ok>

Der oben gezeigte Beispielcode generiert folgende Ausgabe in der Web App:

Radio_Buttons.png