Share via


2.4.8.2.5 CT_Hyperlink

Referenced by: CT_Hyperlinks

The CT_Hyperlink complex type specifies a hyperlink associated with a shape.

Attributes:

Name :  An xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies an identifier for the hyperlink. It MUST NOT be an empty string and MUST be unique amongst the identifiers specified by the Name attribute of the CT_Hyperlink elements in this XML part.

Value :  An optional xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies the URI of an external resource referenced by the hyperlink. It MUST NOT be an empty string. If this attribute exists, SubAddress, SubAddressShape, and Zoom MUST be ignored. If this attribute does not exist, SubAddress MUST exist.

Description :  An optional xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies the description of the hyperlink. If this attribute does not exist then the hyperlink does not have a description.

SubAddress :  An optional xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies the identifier of the drawing page referenced by this hyperlink within the document. It MUST NOT be an empty string. If SubAddress does not exist, SubAddressShape and Zoom MUST be ignored.

SubAddressShape :  An optional xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies the identifier of the shape referenced by this hyperlink within the drawing page specified by SubAddress. It MUST NOT be an empty string. If SubAddressShape does not exist, the hyperlink references the entire drawing page.

Zoom :  An optional xsd:integer ([XMLSCHEMA2] section 3.3.13) attribute that specifies the zoom level for the drawing page specified by SubAddress. If this attribute does not exist then the zoom level is 100%. If this attribute does exist then it MUST be a value from the following table:

Value

Description

-2

The drawing page is zoomed to fit the width of the view.

-1

The drawing page is zoomed to fit in the view.

n > 0

The drawing page is zoomed to n%. n MUST be greater than 0.

Default : An optional xsd:boolean ([XMLSCHEMA2] section 3.2.2) attribute that specifies the default hyperlink associated with the shape. It MUST exist if and only if this hyperlink is the default. Each shape MUST NOT have more than one default hyperlink. If this attribute exists, the value MUST be 1.

The following W3C XML Schema ([XMLSCHEMA1] section 2.1) fragment specifies the contents of this complex type.

 <xsd:complexType name="CT_Hyperlink">
   <xsd:attribute name="Name" type="xsd:string" use="required"/>
   <xsd:attribute name="Value" type="xsd:string" use="optional"/>
   <xsd:attribute name="Description" type="xsd:string" use="optional"/>
   <xsd:attribute name="SubAddress" type="xsd:string" use="optional"/>
   <xsd:attribute name="SubAddressShape" type="xsd:string" use="optional"/>
   <xsd:attribute name="Zoom" use="optional">
     <xsd:simpleType>
       <xsd:union>
         <xsd:simpleType>
           <xsd:restriction base="xsd:integer">
             <xsd:minExclusive value="0"/>
           </xsd:restriction>
         </xsd:simpleType>
         <xsd:simpleType>
           <xsd:restriction base="xsd:integer">
             <xsd:enumeration value="-2"/>
             <xsd:enumeration value="-1"/>
           </xsd:restriction>
         </xsd:simpleType>
       </xsd:union>
     </xsd:simpleType>
   </xsd:attribute>
   <xsd:attribute name="Default" type="xsd:boolean" use="optional"/>
 </xsd:complexType>