Share via


Address Element

Visio XML Reference

Specifies a URL address, DOS file name, or UNC path to jump to.

You can specify Address as a relative path based on the hyperlink base path defined for the document. If the document has no base path, Visio navigates based on the document path. If the document hasn't been saved, the hyperlink is undefined.

Syntax

  <Address
    [Unit]
    [F]
    [Err]
    [V]>
</Address>

Attributes

Unit

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

V

Optional string. Represents the null string condition for a string cell value. In some cases it is helpful to distinguish between an empty string cell null and a null string cell value. This attribute is used to distinguish between these forms of an empty value.

Element properties

Property Value
Name Address 
Minimum Occurrences
Maximum Occurrences

Element information

Parent elements

Hyperlink

Child elements

None

Remarks

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

Example

In the following example, the Address element contains the URL for the Visio Developer Center on the Microsoft Developer Network (MSDN) Web site.

XML
  <Hyperlink ID="1">
   <Description>The Visio Developer Center</Description> 
   <Address>http://msdn.microsoft.com/visio/</Address> 
   <SubAddress>&#xe000;</SubAddress> 
   <ExtraInfo>&#xe000;</ExtraInfo> 
   <Frame F="No Formula" /> 
   <NewWindow>0</NewWindow> 
   <Default>0</Default> 
</Hyperlink

See also

Address cell (Hyperlinks section)

Address property

Hyperlink element

HyperlinkBase property