UIVisibility Element

Determines whether the page name is exposed in the user interface (UI).

Value

Description

0

Display the page name in the UI (the default).

1

Do not display the page name in the UI.

Syntax

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

Attributes

Unit

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

UIVisibility

Minimum Occurrences

0

Maximum Occurrences

1

Element information

Parent elements

PageProps

Child elements

None

Setting the UIVisibility element to 1 (hidden) prevents the page from appearing anywhere in the UI where the string containing the page name appears. For example, the page would not be listed as an option in the Page dialog box ( Edit menu, Go To submenu), in the Drawing Explorer , or on the page tabs. You can still access the page, however, by using Automation or by taking UI paths that do not include the page name, for example, the Print command.

Note

To hide a page from the document's Print command, make it a background page (the Type property is visTypeBackground) that is not used as a background by any page (shapes on background pages are printed when a page that is using it as a background is printed). The document's Print command only works with indexed pages, and background pages are not indexed. This element is intended for use with document pages; it is not intended for use with markup overlay pages, which have the UIVisibility element set to 1 (hidden) by default and should not be changed.

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

See also

UIVisibility cell (Page Properties section)