Manipulator

Manipulator[x]

represents a manipulator with setting x in the range 0 to 1.

Manipulator[Dynamic[x]]

takes the setting to be the dynamically updated current value of x, with the value of x being reset if the manipulator is moved.

Manipulator[x,{xmin,xmax}]

represents a manipulator with range xmin to xmax.

Manipulator[x,{xmin,xmax,dx}]

represents a manipulator that jumps in steps dx.

Details and Options

  • Manipulator[] displays in a notebook as a horizontal slider and a collection of additional controls that can be manipulated interactively.
  • Manipulator[Dynamic[x]] will reset the value of x when the manipulator setting is changed; Manipulator[x] will not. »
  • Manipulate by default generates Manipulator objects for variables that are specified to have ranges of possible values.
  • The following options can be given:
  • AppearanceAutomaticthe overall appearance of the manipulator
    AppearanceElementsAutomaticelements to include in the displayed manipulator
    BaselinePositionAutomaticalignment relative to surrounding text
    ContinuousActionTruewhether to update continuously when the manipulator controls are changed
    EnabledAutomaticwhether the manipulator is enabled, or grayed out
    ImageMargins0margins around the image of the displayed manipulator
    ImageSizeAutomaticthe overall image size of the displayed manipulator
  • Possible settings for Appearance include Tiny, Small, Medium, and Large. Other possible settings include "Open" and "Closed", or combinations such as {"Open",Small}.
  • Appearance->"Labeled" displays the current value of the manipulator as an editable label.
  • The following elements are included in a default manipulator: "InputField", "StepLeftButton", "PlayPauseButton", "StepRightButton", "FasterSlowerButtons", "DirectionButton", "InlineInputField". These elements can be specified in any order in a list given as the setting for AppearanceElements.
  • Manipulator[] is equivalent to Manipulator[0].

Examples

open allclose all

Basic Examples  (4)

Default and nondefault initial states:

Dynamically change the value of x:

Specify a range:

Specify a step size and range:

Scope  (4)

Use only integer values:

Use symbolic range:

View the animation controls:

Parameters that are neither numeric nor Dynamic do not display as a manipulator:

Options  (16)

AnimationDirection  (1)

Specify the direction for animation when the play button is clicked:

AnimationRate  (1)

Change the rate of animation when the play button is clicked:

Appearance  (3)

Use preset values:

Open or close the element area:

Combine the two appearance options:

AppearanceElements  (3)

Specify which control elements should appear below the slider:

All possible appearance elements:

A random choice of appearance elements:

AutoAction  (2)

By default, the manipulator responds to mouse clicks:

By setting AutoAction, values will change when the mouse moves over the manipulator:

ContinuousAction  (2)

By default, variables are continuously updated:

Make variables update only when the mouse is released:

Enabled  (1)

By default Manipulator is enabled:

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

Exclusions  (1)

Exclude values from the range:

ImageSize  (2)

Control the size using preset values only:

Or use any values:

Applications  (1)

Modulate the frequency:

Properties & Relations  (1)

Manipulate automatically uses Manipulator controls:

Introduced in 2007
 (6.0)