Share via

<Status> element

  • Article

<Status> element

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

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 = "unitval"]

      [F = "formula"]

      [Err = "error"]>

  </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 the string "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 information

Parent elements:

Layer

Child elements:

None

Remarks

In a 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.