Next: , Previous: menu-choice, Up: Basic Types

5.8 The radio-button-choice Widget

Syntax:

     type ::= (radio-button-choice [keyword argument]...  type ... )

The component types specify the choices, with one radio button for each. The widget's value will be that of the chosen type argument. This widget matches any value that matches 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
Replace 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.