Share via

Status Element

  • Article
Visio XML Reference

Specifies whether the layer is a valid layer for a document.

Value Description

0

The layer is currently a valid layer in the document.

1 or 2

The layer is no longer a valid layer in the document.

Syntax

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

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

Element information

Parent elements

Layer

Child elements

None

Remarks

In a Microsoft Office Visio document, layers that are removed are not deleted from the document, because doing so would invalidate the IDs used to reference a Layer element from a Shape element. Instead, the layers are given a non-zero status and remain in the document to preserve the IDs of other layers. Layers with a status of 1 or 2 are not accessible from within the Visio application and are ignored by automation methods.

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