Whenever the selection of a choice item is changed by the user, the choice item’s callback procedure is invoked. A callback procedure is provided as an initialization argument when each choice item is created.

See also list-box%.

If & occurs in label, it is specially parsed as for button%.

The choices list specifies the initial list of user-selectable items for the control. The initial set of choices determines the control’s minimum graphical width (see Geometry Management for more information).

The callback procedure is called (with the event type 'choice) when the user selects a choice item (or re-selects the currently selected item).

If style includes 'vertical-label, then the choice item is created with a label above the control; if style does not include 'vertical-label (and optionally includes 'horizontal-label), then the label is created to the left of the choice item. If style includes 'deleted, then the choice item is created as hidden, and it does not affect its parent’s geometry; the choice item can be made active later by calling parent’s add-child method.

By default, the first choice (if any) is initially selected. If selection is positive, it is passed to set-selection to set the initial choice selection. Although selection normally must be less than the length of choices, it can be 0 when choices is empty.