Generic Radio Button Widget
The Generic Radio Button widget is a multi-option select button. Only one button, or State, can be selected at a time. The Radio Button is an input control, so the designed use is to set a value based on the user selection.
The possible selections are configured by assigning a state definition (State) by selecting one of the defined states in the mashup environment. For example, if you have three running conditions for a motor (On/Off/Auto) and you wanted an operator to set the running condition, you would define a state definition with those three states. Then, that state definition could be used whenever you want to have an On/Off/Auto button on a mashup.
Each of the states in the state definition will be automatically linked to a single button in the button group. The displayed text will be the display string from the style associated with each individual state, and will be shown in the color scheme of the corresponding style.
There is a SelectedText and a SelectedValue parameter so you can have an index, a text output, or both.
 |
The Generic Radio Button and Radio Button are functionally the same. They do, however have different styling, Generic Radio Buttons resemble the classic Java GUI implementation.
|
|
|
Styles and common widget properties are not included in the table below.
|
|
Property Name
|
Description
|
Base Type
|
Default Value
|
Bindable? (Y/N)
|
Localizable? (Y/N)
|
|---|---|---|---|---|---|
|
Orientation
|
Button alignment (horizontal or vertical).
|
STRING
|
Vertical
|
N
|
N
|
|
SelectedValue
|
Get or Set value that drives the State
|
STRING
|
Vertical
|
Y
|
N
|
|
SelectedText
|
Get or Set the name of the selected State.
|
STRING
|
n/a
|
Y
|
N
|
|
ReadOnly
|
If set to true only displays the current state
|
BOOLEAN
|
False
|
N
|
N
|
|
ButtonStates
|
Choose a state definition and the radio button will auto-populate the buttons with the state names and values.
|
STATEDEFINITION
|
True
|
N
|
N
|
|
ShowDataLoading
|
Displays a spinning icon when data is loading.
|
BOOLEAN
|
True
|
N
|
N
|
|
SelectionChanged
|
Event. Fires when the selected button changes.
|
n/a
|
n/a
|
Y
|
N
|
|
Visible
|
Is the widget visible in run time?
|
BOOLEAN
|
True
|
N
|
N
|
For information on the related radio button widgets, see Button Bar Widget and Radio Button Widget.