9.2

Creating and using hyperlinks
There are three types of hyperlink:
•
Web (WWWURL).
•
Anchor (ANCHOR). You must define Anchor hyperlinks at the <LAYOUT> level.
•
Page (PAGE). You must define Anchor hyperlinks at the <LAYOUT> level.
Web hyperlinks
You must define Web hyperlinks at the <PROJECT> level. For example, to create a Web
hyperlink named Quark-dot-com, you could add the following as a child of the <PROJECT>
element:
<HYPERLINK HLTYPE="WWWURL" NAME="Quark-dot-com" TARGET="http://www.quark.com"/>
To add a Web hyperlink to a layout, add HYERLINKREF and HLTYPE attributes to a <BOX>
or <RICHTEXT> element. For example, to use the Quark-dot-com hyperlink defined above,
you could do something like this:
<RICHTEXT>this is a hyperlink to </RICHTEXT>
<RICHTEXT COLOR="Cyan" UNDERLINE="true" HYPERLINKREF="Quark-dot-com"
HLTYPE="WWWURL">quark.com</RICHTEXT>
You can use a Web hyperlink without creating it at the <PROJECT> level, but this is not
the preferred method.
Anchor hyperlinks
To indicate the target of an Anchor hyperlink, use a <RICHTEXT> element like this:
<RICHTEXT HLANCHORREF="MyAnchor" />
To make sure the Anchor hyperlink works correctly, add something like this to the
<LAYOUT> element:
<HYPERLINK HLTYPE="ANCHOR" TARGET="#somewhere" />
To link to this Anchor hyperlink, use something like this:
<RICHTEXT HLTYPE="ANCHOR" HYPERLINKREF="#somewhere">link</RICHTEXT>
You can use an Anchor hyperlink without creating it at the <PROJECT> level, but this is
not the preferred method.
Page hyperlinks
To make sure a Page hyperlink works correctly, add something like this to the <LAYOUT>
element:
<HYPERLINK HLTYPE="PAGE" NAME="Page 2" TARGET="2" />
To link to this Page hyperlink, use something like this:
<RICHTEXT HLTYPE="PAGE" HYPERLINKREF="Page 2" >Page2</RICHTEXT>
You can use a Page hyperlink without creating it at the <PROJECT> level, but this is not
the preferred method.
QXP SERVER 9.2 WEB INTEGRATION GUIDE | 111
USING THE WEB INTERFACE