Hyperlink

This widget defines a hyperlink in a static server page. (To use an image as a hyperlink, use the Image USP widget.)

XHTML Specification: <x-subst type="Hyperlink">

For more information, see <x-subst type="WidgetType"> .

Widget Properties

Widget Properties
Property	Description/More Information
Exclude	Exclude the field if it does not need to be sent to the browser.
Link Text (u_hyperldispl)	Visible text of the link; dynamic
Link Value (u_url)	Target URL of the hyperlink; dynamic
Target Window (u_target)	Type of window in which the target page appears; dynamic

Description

When the field definition is copied to the layout, the XHTML source code is similar to the following:

<x-subst name="LINK.MY_ENTITY.MY_MODEL" type="hyperlink">
<a href="http://google.nl" target="_blank">Google</a>
</x-subst>

Dynamic Property Values

The dynamic properties of the hyperlink control specify the link text, target URL and window type in which the new page is opened. The actual values can be provided at runtime.

Uniface uses the = ProcScript statement to evaluate the contents of these properties at run time, so you can use field substitutions to generate the desired URL. For example, you can enter the following values in the properties:

Link Text: %%LINKTXT.MYENT.MYMODEL%%% to use the contents of the LINKTXT field.
Link Value: %%LINKVALUE.MYENT.MYMODEL%%% to use the contents of the LINKVALUE field.
Target Window%%TARGETWIN.MYENT.MYMODEL%%% to use the contents of the TARGETWIN field

The Hyperlink control uses the = ProcScript statement to evaluate these values. Each value is concatenated and inserted in the <A HREF> tag at runtime.