DropOnPageScale Element

Determines the percentage by which a shape is scaled when it is dropped on the drawing page.

Syntax

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

Attributes

Unit

Optional string. Represents a unit of measure. The default is PER. For details about PER, 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

Element information

Parent elements

Misc

Child elements

None

Remarks

In the following two cases, Microsoft Office Visio scales shapes so that they appear appropriately on the drawing page:

• When unmeasured shapes are dropped onto scaled drawings.
• When measured shapes are dropped onto unscaled drawings.

The percentage in the DropOnPageScale element indicates the factor by which Visio scaled the shape, either up (>100) or down (<100). You can use this number as a factor when calculating hard-coded values.

This value is 100% for measured shapes on scaled drawings or unmeasured shapes on unscaled drawings.

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

See also

DropOnPageScale cell (Miscellaneous section)