ReadOnly Element [Visio 2003 SDK Documentation]

Article
05/01/2007

Determines whether the action on a smart tag or shortcut menu is read-only.

Value	Description
TRUE	The action appears on the menu but is read-only.
FALSE	The action appears on the menu and can be selected (the default).

Syntax

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

Attributes

Unit

Optional string. Represents a unit of measure. The default is BOOL. For details about BOOL, see Units of measure.

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

Element information

Parent elements

Act

Child elements

None

Remarks

When an action is read-only, it appears on the smart tag or shortcut menu but you cannot select it. It does not appear dimmed, but rather it appears on a colored background, like a label. To make the menu item appear dimmed, use the Disabled element.

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