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 »

SetterBar

SetterBar[x, {val1, val2, ...}]
represents a setter bar with setting x and with setter buttons for values vali.
SetterBar[Dynamic[x], {val1, val2, ...}]
takes the setting to be the dynamically updated current value of x, with the value of x being reset every time a setter button is clicked.
SetterBar[x, {val1->lbl1, val2->lbl2, ...}]
represents a setter bar in which the setter button giving value vali has label lbli.
  • The vali and lbli can be strings, boxes, graphics or any other expressions, including dynamic expressions.  »
  • The following options can be given:
AppearanceAutomaticthe overall appearance of the setter bar
BaselinePositionAutomaticalignment relative to surrounding text
BaseStyle{}base style specifications for the setter bar
EnabledAutomaticwhether the setter bar is enabled, or grayed out
  • Possible settings for the Appearance option include:
"Horizontal"equally spaced horizontally
"Vertical"equally spaced vertically
"Row"laid out like text, allowing linewrapping
  • The settings for BaseStyle are appended to the default style typically given by the "SetterBar" style in the current stylesheet.
EXAMPLESCLOSE ALL
Basic Examples   (2)
Use five possible settings:
Dynamically change the value of x:
Use five possible settings:
In[1]:=
Click for copyable input
Out[1]=
 
Dynamically change the value of x:
In[1]:=
Click for copyable input
Out[1]=
Scope   (2)
Include labels:
Values and labels can be any expression:
Options   (5)
Change the orientation of SetterBar:
The Appearance option "Row" allows linewrapping, while "Horizontal" does not:
Change the background color:
Align with the surrounding text:
By default, SetterBar is enabled:
By setting Enabled->False, the setter bar is disabled but visible in its current state:
Applications   (1)
Alter the frequency:
New in 6
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team