represents a checkbox bar with setting x and with checkboxes for values vali to include in the list x.


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.


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.


open all close all

Basic Examples  (2)

Create checkboxes with specified states:

Click for copyable input

Include labels:

Click for copyable input

Scope  (3)

Options  (9)

Properties & Relations  (2)

Possible Issues  (1)

Introduced in 2007
Updated in 2008