Mobile Apps
Engineering, R&D
Web & Software
Finance, Statistics & Business Analysis
Need Help?
Premium Support
Work with Us
Initiatives
BUILT-IN WOLFRAM LANGUAGE SYMBOL
Manipulate
[expr,{u,umin,umax}]generates a version of expr with controls added to allow interactive manipulation of the value of u.
[expr,{u,umin,umax,du}]allows the value of u to vary between
in steps du.
[expr,{{u,uinit},umin,umax,…}]takes the initial value of u to be .
[expr,{{u,uinit,ulbl},…}]labels the controls for u with .
[expr,{u,{u1,u2,…}}]allows u to take on discrete values .
[expr,{u,…},{v,…},…]provides controls to manipulate each of the .
[expr,&cu&{u,…},&cv&{v,…},…]links the controls to the specified controllers on an external device.
The expression expr can be any graphic or other expression. If it is , only the controls are displayed.
The following forms by default yield particular forms of controls:
{u,umin,umax}manipulator (slider, animator, etc.)
{u,umin,umax,du}discrete manipulator with step du
{u,{xmin,ymin},{xmax,ymax}}2D slider
{u,}a locator in a graphic
{u,{u1,u2,…}}setter
popup menu for more
{u,{u1-&lbl1,u2-&lbl2,…}}setter bar or popup menu with labels for elements
{u,{, }}checkbox
{u,color}color slider
{u}blank input field
{u,func}create an arbitrary control from a function
{{u,uinit},…}control with initial value
{{u,uinit,ulbl},…}control with label
{{u,…},…,opts}control with particular options
[…]general control object
horizontal delimiter
string, view, cell expression, etc.explicit text, view, cell, etc. annotations
Possible annotations given in place of controls include expressions with heads , , , , , ,
as well as views and layout constructs such as , , and .
Inside annotations, controls can be specified using .
for a control can be any expression.
The option setting -&type attempts to use controls of the specified type.
Possible control types include: , , , , , , , ,
or , , , , , and .
can also be used.
options can be given separately for each variable. Options for the controls can also be given within the specification for the variables.
-&Trigger specifies that a particular variable should be controlled by a trigger.
The control specification {u,umin,umax,…,-&&Labeled&} yields a slider with the value displayed as a label.
In the form , [u] is given as the first argument to func.
what is evaluated is then func[[u],{umin,umax}].
The form {u} is equivalent to {u, }. {u, } gives a default color slider as a control.
In the form {u,}, the value of u is a list giving x and y coordinates. The coordinates refer either to the first graphic in expr, or range from 0 to 1 in each direction across expr.
The form {{u,{{x1,y1},{x2,y2},…}},} sets up a locator for each of the , and makes the value of u be the list of all .
The form {{u,uinit},{xmin,ymin},{xmax,ymax},} specifies a range for the locators.
The option setting -&All specifies that new locators should be added for clicks that do not hit existing locators. Alt+Click deletes locators.
{{u,{}},,-&} starts with no locators, but allows locators to be created.
If a variable u is used more than once, linked controls for it are given.
The option setting -&pos specifies that controls should be placed at position pos relative to expr. Possible settings for pos are , , , and .
The placement of an annotation can be specified by enclosing it in an
that has a
The following overall options can be given:
how to align the output in the display area
overall control elements to include in the displayed output
whether to change controls automatically when the mouse is over them
how autorun should use the controls
alignment relative to surrounding text
{}base style specifications for the
{}bookmark settings
the absolute size for the content area
whether to update continuously when controls are changed
when to activate links to external controllers
how external controllers should operate
what external controllers to try to use
placement of controls
type of controls to use
an expression to be evaluated if the output from the
is deleted
whether to make the displayed output deployed
the kernel to use for evaluations
labels for the outer frame
margins inside the overall frame
0margins around the whole
an expression to be evaluated when output is first displayed
interpolation order for animating transitions between bookmarks
{}style specifications for the controls area
whether to localize the variables
whether to put the displayed output in a panel
whether to preserve image size and other options when regenerating graphics
whether to rotate y labels on the frame
whether to save all definitions associated with expr
0how long to delay before shrinking if the displayed object gets smaller
whether to perform initialization synchronously
whether to update synchronously
whether to zoom to fullscreen when activated on a touchscreen
placement of controls on a touchscreen
symbols whose changes trigger updates in the output
variables that, when changed, should be tracked by the front end's undo mechanism
variables whose values should not be saved
The options
can be given separately for each variable, in the form .
is a scoping construct that implements lexical scoping.
generates a
object, with the variables u, v, etc. specified as local.
With the default setting -&{}, values of the variables u, v, etc. are automatically saved in notebooks, and restored when the notebooks are reopened.
With a setting :&expr, the expression expr is evaluated when
is executed, or when the result is first displayed in a particular session.
The setting for
can be a list in any order of the following: , , , . By default, only
is included.
Clicking the snapshot button creates a cell directly below the
output, containing input of the form [{u=uval,…},expr] specifying current values of all variables.
With the setting -&, an explicit Update button is displayed, and expr is not reevaluated until this is clicked.
With the default setting -&, only symbols that appear explicitly in expr are tracked.
-& tracks symbols that appear in the controls of .
With -&, the output is updated whenever any symbol encountered in its evaluation is changed.
With the default setting -&, controls in a
respond to specified controllers on an external device whenever the
is part of the current selection.
Controllers on an external device such as a gamepad can include joysticks, buttons, etc.
Typical external controller specifications include:
or xprimary x value
or yprimary y value
or zprimary z value
or {x,y}primary 2-axis controller value
or {x,y,z}primary 3-axis controller value
, , , etc.x, y, , etc.values from a secondary controller
, etc.x, etc.values taken to be cyclic
, etc.x, etc.values from absolute control positions
, , etc., , etc.toggling button states
, , etc., , etc.instantaneous button states
Raw external controller specification names for devices active in a particular Wolfram System session can typically be found using .
With the default setting -&, a controller specification such as
means that the displacement of a control such as a joystick by default determines the rate of change of the corresponding variable x. If an alternate state is selected, for example by depressing the joystick, then the absolute position of the control directly determines the value of x.
With a controller specification such as , the absolute position of a control such as a joystick determines the value of the corresponding variable x.
With a controller specification such as , the value of the corresponding variable x is typically taken to wrap around cyclically when the control reaches the end of its range.
A controller specification such as
may be associated with multiple controls on an external device, such as axes on two distinct joysticks on a single controller.
On a gamepad or other device with two joysticks,
typically refers to the left joystick, and
to the right one. If a gamepad has a &hat& control, this is typically referred to as .
Button controller specifications such as
toggle between
whenever the corresponding button is pressed.
Absolute specifications such as
while the button is being pressed, and
otherwise.
The settings for
are appended to the default styles typically given by the
styles in the current stylesheet.
Manipulate a continuous parameter:
Manipulate a parameter in discrete steps:
Manipulate two parameters:
Give defaults and names for parameters:
                   
Introduced in 2007 (6.0) | Updated in 2012 (9.0)
Please complete this field.
Name (optional)
Email address (optional)
Send Feedback
For Customers
Public Resources
Enable JavaScript to interact with content and submit forms on Wolfram websites.& 开源中国(OSChina.NET) |
开源中国社区(OSChina.net)是工信部
指定的官方社区Mobile Apps
Engineering, R&D
Web & Software
Finance, Statistics & Business Analysis
Need Help?
Premium Support
Work with Us
Initiatives
Try Mathematica for Free
Sign in or create a Wolfram ID to get your free 15-day trial of Mathematica. The trial includes a download of Mathematica 10, along with access to Mathematica Online.
*Required field
Don't have a Wolfram ID?
You'll have an opportunity to create a new Wolfram ID in the next step.
Sign in with your Wolfram ID
Wolfram ID (your email address)*
This field is required
Enter valid email address
This field is required
Enter at least 6 characters, no spaces
For Customers
Public Resources
Enable JavaScript to interact with content and submit forms on Wolfram websites.