WOLFRAM

Wolfram Language & System Documentation Center

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,{val1lbl1,val2lbl2,…}]

represents a setter bar in which the setter button giving value vali has label lbli.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
Appearance  
Background  
BaselinePosition  
Enabled  
Applications  
Properties & Relations  
See Also
Tech Notes
Related Guides
Related Workflows
History
Cite this Page

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,{val1lbl1,val2lbl2,…}]

represents a setter bar in which the setter button giving value vali has label lbli.

Details and Options

  • The vali and lbli can be strings, boxes, graphics, or any other expressions, including dynamic expressions. »
  • The following options can be given:
  • Appearance Automaticthe overall appearance of the setter bar
    BaselinePosition Automaticalignment relative to surrounding text
    BaseStyle{}base style specifications for the setter bar
    Enabled Automaticwhether 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
  • Appearance->"Vertical"->{h,w} will display the controls in a grid with the specified number of columns and rows, vertically filling each column in turn. Appearance->"Horizontal"->{h,w} horizontally fills the rows instead.
  • If one of h or w is Automatic, it is taken to be the smallest number so that all the controls will fit in the resulting grid. If both h and w are Automatic, they are calculated so the grid has roughly the same number of rows as columns.
  • The settings for BaseStyle are appended to the default style typically given by the "SetterBar" style in the current stylesheet.

Examples

open all close all

Basic Examples  (2)

Use five possible settings:

Wolfram Language code: SetterBar[1, Range[5]]

Dynamically change the value of :

Wolfram Language code: {SetterBar[Dynamic[x], Range[5]], Dynamic[x]}

Scope  (2)

Include labels:

Wolfram Language code: SetterBar[1, {1 -> " I ", 2 -> " II ", 3 -> " III "}]

Values and labels can be any expression:

Wolfram Language code: g = Plot[Sin[x], {x, 0, 2π}, Axes -> False, ImageSize -> 40]; f = Sqrt[y]Tan[α y - β]; s = "αβγ";
Wolfram Language code: {SetterBar[Dynamic[x], {g, f, s}], Dynamic[x]}

Options  (6)

Appearance  (3)

Change the orientation of SetterBar:

Wolfram Language code: Table[SetterBar[1, Range[4], Appearance -> a], {a, {"Horizontal", "Vertical"}}]

The Appearance option "Row" allows line wrapping, while "Horizontal" does not:

Wolfram Language code: SetterBar[1, Range[30], Appearance -> "Horizontal"]
Wolfram Language code: SetterBar[1, Range[30], Appearance -> "Row"]

Specify a three-column layout, with elements ordered vertically:

Wolfram Language code: SetterBar[Dynamic[props], CityData["Properties"], Appearance -> "Vertical" -> {Automatic, 3}]

Background  (1)

Change the background color:

Wolfram Language code: Table[SetterBar[2, Range[5], Background -> c], {c, {Pink, Gray, Yellow, Purple}}]

BaselinePosition  (1)

Align with the surrounding text:

Wolfram Language code: Row[Table[SetterBar[2, Range[5], BaselinePosition -> p], {p, {Top, Center, Bottom}}], "xxx"]

Enabled  (1)

By default, SetterBar is enabled:

Wolfram Language code: SetterBar[1, Range[5]]

By setting Enabled->False, the setter bar is disabled but visible in its current state:

Wolfram Language code: SetterBar[2, Range[5], Enabled -> False]

Applications  (1)

Alter the frequency:

Wolfram Language code: Dynamic[Plot[Sin[n x], {x, 0, 2π}, PlotLabel -> SetterBar[Dynamic[n], Range[10]]]]

Properties & Relations  (1)

RadioButtonBar is a special case of SetterBar:

Wolfram Language code: {RadioButtonBar[Dynamic[x], Range[5]], Dynamic[x]}
Wolfram Language code: {SetterBar[Dynamic[y], Range[5]], Dynamic[y]}
Wolfram Research (2007), SetterBar, Wolfram Language function, https://reference.wolfram.com/language/ref/SetterBar.html.

Text

Wolfram Research (2007), SetterBar, Wolfram Language function, https://reference.wolfram.com/language/ref/SetterBar.html.

CMS

Wolfram Language. 2007. "SetterBar." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/SetterBar.html.

APA

Wolfram Language. (2007). SetterBar. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/SetterBar.html

BibTeX

@misc{reference.wolfram_2026_setterbar, author="Wolfram Research", title="{SetterBar}", year="2007", howpublished="\url{https://reference.wolfram.com/language/ref/SetterBar.html}", note=[Accessed: 13-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_setterbar, organization={Wolfram Research}, title={SetterBar}, year={2007}, url={https://reference.wolfram.com/language/ref/SetterBar.html}, note=[Accessed: 13-June-2026]}