Choice is an interface that contains the methods common to user
interface components that allow the user to choose from several possible alternatives.
This interface is implemented by the full-screen
List control and
ChoiceGroup, which is an
Choice can operate in one of three different modes:
Only one alternative can be selected. If the user selects one item from the set of offered alternatives, any item already selected is deselected. In this mode, the control behaves as (and is usually rendered to look like) a set of radio buttons.
Any number of alternatives can be selected. Selecting one item from the list has no effect on the selected state of other entries. In this, the control behaves like a collection of check boxes.
This mode is available only with the
List control. It allows
only one item to be selected at any given time and is typically used to create a menu.
The difference between this mode and
EXCLUSIVE, apart from the visual
differences, lies in the way in which selection changes are notified to application code.
See the description of the
List control for details.
Each entry in a
Choice consists of one or both of an image provided
in the form of an
Image object and a text string. The image, if provided,
is rendered in addition to any icon, such as a check box or radio button, supplied by the control
The number of entries
can be obtained by calling the
size() method. An entry is distinguished by its index, ...