Setter

Setter[x, val]
represents a setter button whose setting x is set to val when the button is clicked. The button is labeled with val, and appears pressed if the value of x is val, and unpressed otherwise.

Setter[Dynamic[x], val]
takes the setting to be the dynamically updated current value of x, with the value of x being reset if the button is clicked.

Setter[x, val, label]
labels the setter button with label.

Setter[x, {val1, val2, ...}, label]
represents a setter button that sets x to if multi-clicked n times.

Details and OptionsDetails and Options

  • Setter[x, val] takes x still to be val even if it is clicked more than once.
  • Setter[x, {val1, ..., valn}, label] takes x still to be if it is multi-clicked more than n times.
  • The following options can be given:
  • AppearanceAutomaticthe overall appearance of the setter
    AutoActionFalsewhether to change the setter automatically when the mouse is over it
    BaselinePositionAutomaticalignment relative to surrounding text
    BaseStyle{}base style specifications for the setter
    EnabledAutomaticwhether the setter is enabled, or grayed out
    ImageMargins0margins around the image of the displayed setter
    ImageSizeAllthe overall image size of the displayed setter
  • Typical possible settings for the Appearance option include and . In some cases, , , etc. are also supported.
  • With Appearance->None, label is displayed literally, without being placed in a button.
  • The settings for BaseStyle are appended to the default style typically given by the style in the current stylesheet.

ExamplesExamplesopen allclose all

Basic Examples (1)Basic Examples (1)

A setter with the setting different from its value, showing as unpressed:

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

A setter with the setting equal to its value, showing as pressed:

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

A setter with the label , showing unpressed and pressed states:

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

Dynamically set the value to 1 or 2 by clicking the respective button:

In[4]:=
Click for copyable input
Out[4]=
New in 6
New to Mathematica? Find your learning path »
Have a question? Ask support »