5.8 The radio-button-choice Widget

Syntax:

TYPE ::= (radio-button-choice [KEYWORD ARGUMENT]...  TYPE ... )

The type argument represents each possible choice. The widget’s value will be that of the chosen type argument. This widget will match any value matching at least one of the specified type arguments.

The following extra properties are recognized.

:entry-format

This string will be inserted for each entry in the list. The following ‘%’ escapes are available:

‘%v’

Replaced with the buffer representation of the type widget.

‘%b’

Replace with the radio button.

‘%%’

Insert a literal ‘%’.

button-args

A list of keywords to pass to the radio buttons. Useful for setting e.g. the ‘:help-echo’ for each button.

:buttons

The widgets representing the radio buttons.

:children

The widgets representing each type.

:choice

The current chosen type

:args

The list of types.

You can add extra radio button items to a radio-button-choice widget after it has been created with the function widget-radio-add-item.

Function: widget-radio-add-item widget type

Add to radio-button-choice widget widget a new radio button item of type type.

Please note that such items added after the radio-button-choice widget has been created will not be properly destructed when you call widget-delete.