OnPage Element

Indicates whether the drawing is printed on a specific number of printer pages.

Value	Description
TRUE (1)	Fit the drawing page to a defined number of printer pages.
FALSE (0)	Do not fit the drawing page to a defined number of printer pages (the default).

Syntax

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

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	OnPage
Minimum Occurrences	0
Maximum Occurrences	1

Element information

Parent elements

PrintProps

Child elements

None

If the OnPage element is set to TRUE, Microsoft Visio uses the values in the PagesX and PagesY elements to determine the number of printer pages on which to fit the drawing. Values in the ScaleX and ScaleY elements are ignored. This can be considered an "autoscale" setting.

This value corresponds to the Fit to option on the Print Setup tab in the Page Setup dialog box ( Format menu).

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

See also

OnPage cell (Print Properties section)