Toggler

Toggler[x]
represents a toggler button with setting x, that toggles between True and False.

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

Toggler[x,{val1,val2,}]
represents a toggler button that cycles through any sequence of values .

Toggler[x,{val1pict1,val2pict2,}]
cycles through values displaying them as .

Toggler[x,vlist,dpict]
displays as dpict if x is none of the .

Details and OptionsDetails and Options

  • Checkbox and Opener are effectively special cases of Toggler. »
  • Toggler[x] by default displays as x.
  • Clicking anywhere inside a Toggler advances to the next value.
  • Shift-clicking goes to the previous value.
  • The dpict case cannot be reached by clicking, only by externally setting x. »
  • The and in Toggler can be strings, boxes, graphics or any other expressions, including dynamic expressions. »
  • The following options can be given:
  • AutoActionFalsewhether to change the toggler automatically when the mouse is over it
    BaselinePositionAutomaticalignment relative to surrounding text
    BaseStyle{}base style specifications for the displayed toggler
    ContentPaddingTruewhether to shrink the margins tightly around the contents
    EnabledAutomaticwhether the toggler is enabled or grayed out
    ImageMargins0margins around the image of the displayed toggler
    ImageSizeAllthe overall image size of the displayed toggler
  • Controls such as Button and Slider are not clickable inside Toggler.
  • EventHandler intercepts mouse clicks, but passes them through to Toggler if the setting PassEventsDown->True is given.
  • The settings for BaseStyle are appended to the default style typically given by the style in the current stylesheet.
Introduced in 2007
(6.0)