CheckboxBar

CheckboxBar[x,{val1,val2,}]
represents a checkbox bar with setting x and with checkboxes for values to include in the list x.

CheckboxBar[Dynamic[x],{val1,val2,}]
takes the setting to be the dynamically updated current value of x, with the values in the list x being reset every time a checkbox is clicked.

CheckboxBar[x,{val1lbl1,val2lbl2,}]
represents a checkbox bar in which the checkbox associated with value has label .

Details and OptionsDetails and Options

  • Multiple checkboxes in a CheckboxBar can be checked at the same time. The values associated with all checked checkboxes are given in a list. »
  • The and can be strings, boxes, graphics, or any other expressions, including dynamic expressions. »
  • In CheckboxBar[x,list], Delimiter can appear as an element of list, specifying a vertical delimiter in the displayed setter bar.
  • The following options can be given:
  • AppearanceAutomaticthe overall appearance of the checkbox bar
    BackgroundAutomaticbackground color to use
    BaselinePositionAutomaticalignment relative to surrounding text
    BaseStyle{}base style specifications for each checkbox bar
    EnabledAutomaticwhether the checkbox bar is enabled, or grayed out
    ImageMargins0margins around the displayed checkbox bar
  • 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 and styles in the current stylesheet.
Introduced in 2007
(6.0)
| Updated in 2008
(7.0)