CheckboxBar

CheckboxBar[x,{val1,val2,}]

represents a checkbox bar with setting x and with checkboxes for values vali 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 vali has label lbli.

Details 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 vali and lbli 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 "CheckboxBar" and "CheckboxBarLabel" styles in the current stylesheet.

Examples

open allclose all

Basic Examples  (2)

Create checkboxes with specified states:

In[1]:=
Click for copyable input
Out[1]=

Include labels:

In[1]:=
Click for copyable input
Out[1]=

Scope  (3)

Options  (9)

Properties & Relations  (2)

Possible Issues  (1)

See Also

TogglerBar  RadioButtonBar  Checkbox  ListPicker  Manipulate  Control  AnySubset

Tutorials

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