[Contents] [Index] [Next] [Previous]

RadioButton


Description

A RadioButton should be used to select one option from a number of options. A RadioButton is a special case of a ToggleButton. Only one RadioButton can be set at a time. This component must be composed of a text or graphic label, and a graphic that indicates the state of the RadioButton. The graphic indicator for a RadioButton is usually a filled diamond or circle to indicate the on state or an empty diamond or circle to indicate the off state. On color systems, the on state color can be distinct from general application colors to visually distinguish the on state.

Illustration

Navigation

RadioButtons must have no internal navigation.

Other Operations

The following text describes the operations of this component:

BSelect Press
Must arm the RadioButton. If the RadioButton was previously unset, it must show the RadioButton in the set state.
BSelect Release
If the release happens in the same RadioButton that the press occurred in and if the RadioButton was previously unset, it must be set, and any other RadioButton in the same Panel that was previously set must be unset. The RadioButton must be disarmed, and, if the RadioButton is in a Menu, the Menu must be unposted.
BSelect Release 2
If the RadioButton was previously unset, it should be set, and any other RadioButton in the same Panel that was previously set should be unset. If the RadioButton is in a window, the default action of the window should be activated.
<Enter> or
If the RadioButton is in a window with a default action, the default action must be activated. If the RadioButton is in a Menu:
<Select> or
If the RadioButton was previously unset, it must be set, and any other RadioButton in the same Panel that was previously set must be unset. The RadioButton must be disarmed, and, if the RadioButton is in a Menu, the Menu must be unposted.
Must provide any available help for the RadioButton.

Related Information

For more information, see the reference pages for CheckButton and ToggleButton.