DynamicsOff Element

Specifies whether placeable shapes move and connectors reroute around other shapes and connectors on the drawing page.

Value	Description
0	Enable dynamics.
1	Disable dynamics.

Syntax

<DynamicsOff
    [Unit]
    [F]
    [Err]>
</DynamicsOff>

Attributes

Unit

Optional string. Represents a unit of measure. The default is BOOL. For details about BOOL, see Units of measure.

F

Optional string. Represents the element's formula. This attribute can contain one of the following strings: "someFormula" if the formula exists locally, "No Formula" if the formula is locally deleted or blocked, or "Inh" if the formula is inherited.

If the attribute is not present, the element's formula is a simple constant, for example, <element>5</element>.

Err

Optional string. Indicates that the formula evaluates to an error. The value of Err is the current value (an error message string); the value of the element is the last valid value.

Element properties

Property	Value
Name	DynamicsOff
Minimum Occurrences	0
Maximum Occurrences	1

Element information

Parent elements

PageLayout

Child elements

None

You can disable dynamics to increase your solution's performance. For example, if your solution adds placeable shapes to a drawing and you don't want Microsoft Visio to reroute connectors and reposition shapes each time you add a shape, you can disable dynamics. After your solution adds the shapes, re-enable dynamics.

The DynamicsOff element is relevant only when contained in a PageSheet element. It is ignored when contained in a DocumentSheet , Shape , or StyleSheet element.

See also

DynamicsOff cell (Page Layout section)