Mathematica 9 is now available

THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.

DOCUMENTATION CENTER SEARCH

New to Mathematica? Find your learning path »

Mathematica > Dynamic Interactivity > Control Objects > Checkbox >

Checkbox

Checkbox[x]
represents a checkbox with setting x, displayed as

when x is True and

when x is False.

Checkbox[Dynamic[x]]
takes the setting to be the dynamically updated current value of x, with the value of x being toggled if the checkbox is clicked.

represents a checkbox that toggles between values

and

, and displays as

and

respectively.

represents a checkbox that cycles through values

, and displays as

for all

with i>2.

MORE INFORMATION

Checkbox is effectively a special case of Toggler.

The following options can be given:

	Appearance	Automatic	the overall appearance of the checkbox
	AutoAction	False	whether to change the checkbox automatically when the mouse is over it
	BaselinePosition	Automatic	alignment relative to surrounding text
	Enabled	Automatic	whether the checkbox is enabled, or grayed out
	ImageMargins	0	margins around the image of the displayed checkbox

Typical possible settings for Appearance include Small, Medium, and Large.

Checkbox is equivalent to Checkbox[False].

Basic Examples (2)

The default states for Checkbox:

Using different values for states:

The default states for Checkbox:

Out[1]=

Using different values for states:

Out[1]=

By using Dynamic variables within Checkbox the state variable is dynamically updated:

Here the value of x cycles through the list

:

Control the appearance of the checkbox:

Dynamically changing appearance:

By default, the checkbox does not change state until it is clicked:

By setting AutoAction, the checkbox changes state when the mouse moves over it:

Values will change as the cursor is moved over the clickable area:

Change the background color:

Dynamically change the background color:

Align with surrounding text:

The Enabled option allows the checkbox to be changed:

The Enabled option can be changed dynamically for use in applications:

Change the margins around the image:

Applications (4)

Use Checkbox to set variables corresponding to a three-way light switch:

Control options through checkboxes:

Use checkboxes to build a dynamic truth table:

Count the number of clicks in a Checkbox:

Properties & Relations (1)

Checkbox is a special case of Toggler:

Toggler Opener Setter Panel RadioButton Control

Introduction to Dynamic

Introduction to Control Objects

Generalized Input

New in 6

Ask a question about this page | Suggest an improvement | Leave a message for the team

Format: HTML | CDF