The Radio Button Widget

View Class: RadioButton
Spec Class: RadioButtonSpec

The Radio Button Widget is used to provide mutually exclusive choices. Usually several radio buttons are placed in groups where only one of the buttons may be selected and stay selected until another button of the group is selected. The selection is indicated by having a dot in the center.

The Basics Section:

ID	Unique symbolic name (ID) of the button. This ID can be used by the application to access the widget via `"builder>>componentAt:#ID"`.
Label	Label of the button. If the check box Label Is Image is turned off, this is the label string. Otherwise, it is the name of the selector, which returns the label - either a string or a bitmap from the application.
Model	Aspect selector or binding for the group definitions of the radio buttons. It should return a `RadioButtonGroup` instance.
Value	Defines the string which is set in the `RadioButtonGroup` instance above when the button is pressed. If not defined, a sequential number (1,2,3,...) is used to set.
Be Default	Turns on/off displaying of a return key after the label string.
Size As Default	Turns on/off that the button computes its size including space for the default (return) image. Useful for buttons which are initially not default buttons, but become a default button dynamically.
Label Is Image	Turns on/off that the name of the label is taken as selector. The selector should return a string or bitmap image used as logo in the button.
Translate Label	Turns on/off that the label string is translated via the resource mechanism to a national language string. A translation for that string must be define in the resource file of the application class.

The Details Section:

Font	Defines the font style of the button's label. After selecting the check toggle the font style can be chosen by selecting one of the Family/Face/Style/Size buttons. If no font style is selected, the button takes its default font style from the style sheet.
FG-Color	Defines the foreground color of the button, i.e. the color of the letters. After selecting the check toggle the foreground color can be chosen by selecting the desired colored button. If no color is selected, the button takes its default foreground color from the style sheet.
BG-Color	Defines the background color of the button, i.e. the color of the button's view. After selecting the check toggle the background color can be chosen by selecting the desired colored button. If no color is selected, the button takes its default background color from the style sheet.
Show Lamp	Turns on/off that a colored lamp is shown.
Lamp Color	Defines the color of the lamp. After selecting the check toggle the lamp color can be chosen by selecting the desired colored button. If no color is selected, the button takes its default lamp color from the style sheet.
Initially Disabled	Turns on/off that the button is initially disabled.
Initially Invisible	Turns on/off that the button is initially invisible.
Can Tab	Turns on/off that the button can be reached by tabbing.

The Channels Section:

Enable	Aspect selector or binding for en-/disabling the button. It should return a - `Boolean` instance** (only for static behavior) - `ValueModel`* instance with a `Boolean` instance** A value model is used to provide a dynamically changing of the ability of the button.
Label	Aspect selector or binding for the label of the button. It should return a `ValueModel`* instance with a `String` instance. It is used to provide a dynamically changing of the label.
FG-Color	Aspect selector or binding for the foreground color of the button. It should return a - `Color` instance (only for static behavior) - `ValueModel`* instance with a `Color` instance. A value model is used to provide a dynamically changing of the foreground color.
BG-Color	Aspect selector or binding for the background color of the button. It should return a - `Color` instance (only for static behavior) - `ValueModel`* instance with a `Color` instance. A value model is used to provide a dynamically changing of the background color.

* = ValueHolder, AspectAdaptor, BufferedValueHolder, RangeAdaptor, TriggerValue
** = true, false

Selected Name of the selector sent to the application when the button was pressed.

The Help Section:

see document "Using the Help Tool"

The Layout Section:

see document "The Layout of the Widgets"