Mathematica 9 is now available
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
Wolfram Mathematica Documentation Center
DOCUMENTATION CENTER SEARCH
New to Mathematica? Find your learning path »
Mathematica > Dynamic Interactivity > Control Objects > CheckboxBar >
BUILT-IN MATHEMATICA SYMBOLTutorials »|See Also »|More About »

CheckboxBar

CheckboxBar
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
represents a checkbox bar in which the checkbox associated with value has label .
MORE INFORMATION
  • 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, 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
  • The settings for BaseStyle and LabelStyle are appended to the default styles typically given by the and styles in the current stylesheet.
EXAMPLESCLOSE ALL
Basic Examples   (2)
Create checkboxes with specified states:
Include labels:
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)
Use a dynamically updated setting:
Use any expression as a value:
Separate choices with a Delimiter:
Options   (7)
Alter the size:
Alter the orientation:
Using the setting will allow the row of checkboxes to linebreak:
Change the background dynamically:
Align the labels with surrounding text:
By default, CheckboxBar is enabled:
By setting Enabled->False, the checkbox bar is disabled but visible in its current state:
Properties & Relations   (2)
CheckboxBar is a special case of TogglerBar:
CheckboxBar is built using Checkbox and can be used to track a list of values:
Possible Issues   (1)
Values are added in the order clicked rather than in the order given by the list of possible values:
New in 6 | Last modified in 7
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team
Format:   HTML  |  CDF