The Do command evaluates its argument using values retrieved from specified embedded components.

Optionally, the result can be stored into an embedded component

A naming convention is used to access component values.The expression %name refers to the component named name

By default, the attribute that will be queried or set is value, except for MathExpressionComponent for which the attribute that will be queried or set is expression. Alternate attributes can be specified using %name(attr)

After retrieving an attribute of a component, the result will be parsed and must be a valid Maple expression. To avoid parsing, refer to the component using %%name. Note that parsing of the value attribute of a MathExpressionComponent will result in an error (the expression attribute should be used instead).

After parsing, a type-check can be automatically applied by specifying the type using %name::type or %name(attr)::type. An error will be generated if the expression is not of the given type.

The result of querying component attributes can optionally be stored in a variable or in another component.

To store the value in a variable, use Do(myvar= ... %ComponentName ...).

To store the value in another component, use Do(%Comp1 = ... %Comp2 ...).

Note: Some embedded components, like Label, do not have a value attribute. To retrieve or set attributes on such components, an explicit attribute needs to be specified, e.g. %MyLabel(caption).

By default, when this command is invoked from inside the code which is executed as the action of another embedded component, the document is not updated until that code terminates.  The option refresh = true (or just refresh) can be used to force the document to update during the call to Do.