Mathematica 9 is now available
SEARCH MATHEMATICA 8 DOCUMENTATION
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
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:
A setter with the setting equal to its value, showing as pressed:
A setter with the label Alpha, showing unpressed and pressed states:
Dynamically set the value to 1 or 2 by clicking the respective button:
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]=
Scope   (2)
In this case, single-clicking will return 1 and double-clicking will return 2:
By triple-clicking, this setter will return the setting 3:
Options   (9)
Align labels in the setter:
All possible alignment positions:
Change the appearance:
By default, Setter must be clicked to change the setting:
By setting AutoAction -> True, moving the mouse over the setter changes the setting:
Change the background color:
Align with surrounding text:
By default, Setter is enabled:
By setting Enabled -> False, the setter is disabled, but visible in its current state:
Increase the margins from the label to the frame:
Increase the margins outside the frame:
Alter the overall image size:
Applications   (1)
Set the size of a graphic:
New in 6
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team