Wolfram Mathematica Documentation Center
DOCUMENTATION CENTER SEARCH
Mathematica > Dynamic Interactivity > Control Objects >
Built-in Mathematica SymbolTutorials »|See Also »|More About »

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 which sets x to valn if multi-clicked n times.
  • 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 valn 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 "Frameless" and "Palette". In some cases, "AbuttingLeftRight", "AbuttingRight", 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 "Setter" style in the current stylesheet.
EXAMPLESCLOSE ALL
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 Alpha, 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
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team