RadioButtonBar

RadioButtonBar[x,{val1,val2,}]

represents a radio button bar with setting x and with labeled radio buttons for values vali.

RadioButtonBar[Dynamic[x],{val1,val2,}]

takes the setting to be the dynamically updated current value of x, with the value of x being reset every time a radio button is pressed.

RadioButtonBar[x,{val1lbl1,val2lbl2,}]

represents a radio button bar in which the radio button giving value vali is given label lbli.

Details and Options

  • The vali and lbli can be strings, boxes, graphics, or any other expressions, including dynamic expressions.
  • In RadioButtonBar[x,list], Delimiter can appear as an element of list, specifying a vertical delimiter in the displayed radio button bar.
  • The following options can be given:
  • AppearanceAutomaticthe overall appearance of the radio button bar
    BackgroundAutomaticbackground color to use
    BaselinePositionAutomaticalignment relative to surrounding text
    BaseStyle{}base style specifications for the button bar
    EnabledAutomaticwhether the radio button bar is enabled, or grayed out
    ImageMargins0margins around the displayed radio button bar
    LabelStyle{}style specifications for the labels
  • Possible settings for the Appearance option include: »
  • "Horizontal"equally spaced horizontally
    "Vertical"equally spaced vertically
    "Row"laid out like text, allowing linewrapping
  • Appearance->"Vertical"->{h,w} will display the controls in a grid with the specified number of columns and rows, vertically filling each column in turn. Appearance->"Horizontal"->{h,w} horizontally fills the rows instead.
  • If one of h or w is Automatic, it is taken to be the smallest number so that all the controls will fit in the resulting grid. If both h and w are Automatic, they are calculated so the grid has roughly the same number of rows as columns.
  • Method->"Active" will cause the active area for each item to include the corresponding label.
  • The settings for BaseStyle and LabelStyle are appended to the default styles typically given by the "RadioButtonBar" and "RadioButtonBarLabel" styles in the current stylesheet.

Examples

open allclose all

Basic Examples  (2)

Use five possible settings:

Dynamically updated value:

Scope  (2)

Label the values:

Separate choices with a Delimiter:

Options  (10)

Appearance  (4)

Alter the size:

Alter the orientation:

Using "Row" will allow a RadioButtonBar to include a line break:

Specify a three-column layout, with elements ordered vertically:

Background  (2)

Change the background for the RadioButtonBar:

Change the background color dynamically:

BaselinePosition  (1)

Align the labels with surrounding text:

Enabled  (2)

By default RadioButtonBar is enabled:

By setting Enabled->False, the bar is disabled but visible in its current state:

ImageMargins  (1)

Add margins to the individual radio buttons:

Applications  (1)

A dynamically updated task list:

Introduced in 2007
 (6.0)
 |
Updated in 2008
 (7.0)