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

#### 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`.