Hypertext Viewfile Window

Hypertext Viewfile windows are no longer supported. Instead, you should use HTML Viewfile windows.

A hypertext viewfile window is similar to a text viewfile window except that it can display text with hyperlinks in it. It has a widget type of hypertext.

In the text file to be displayed in a hypertext window, specify hyperlinks in the same format as an HTML anchor tag. You can specify three attributes in the anchor tag:

HREF	Specifies the URL
NAME	Specifies a name that identifies the link; you can jump to this from another link in the document or with the hiScrollWindowToName() function
TARGET	Specifies the window in which to load the page; for example, TARGET="_blank" will load the page in a new browser window while TARGET="_self" will load the page in the same window

For example:

"<A HREF=http://www.cadence.com> Cadence Design Systems</A>"

"<A NAME=cadence href=http://www.cadence.com> Cadence Design Systems</A>"

"<A HREF=http://www.cadence.com> Cadence Design Systems TARGET="_blank" </A>"

"<A HREF="#cadence"> Jump to the Cadence link </A>

All the standard formats for the HREF attribute are supported. For example:

HREF=http://www.myWebsite.com
HREF=mailto://xyz@mycompany.com
HREF="#linkName"
HREF=file:/localfile

where localFile is the name of the local file to load. If localFile is a plain text file, it is loaded into the hypertext field when the link is clicked. If localFile is in PDF, GIF, or JPEG format, it is sent to the Web browser which either displays the file or prompts the user to save it, based on the browser settings. If localFile is in any other format, the browser asks the user whether to open or save the file. In general, however, the hypertext window is intended for plain text, it is not designed to handle all kinds of file formats.)

Web pages will be displayed in the browser specified in the Web Browser field in the User Preferences form or the corresponding ui webBrowser environment variable in your .cdsenv file. The default browser is Netscape.

You can use the following Opus resources to control the hyperlink colors in a hypertext viewfile window:

Opus.hypertextColor	Text color of unvisited hyperlink
Opus.hypertextSelectedColor	Text color of visited hyperlink
Opus.hypertextFocusedColor	Text color of hyperlink when the cursor is over it

You can use hiScrollWindowToName to scroll a hypertext window to a link.

All the functions in this section also apply to hypertext viewfile windows, except for the following selection functions:

hiGetTextSelection, hiGetTextSelByLoc, hiSetTextSelection, hiSelectTextByLoc, hiSetTextSelectAll, hiUnselectText, hiUnselectTextByLoc, hiUnselectTextClass, hiUnselectTextAll, hiGetTextClass, hiSetTextClass.

Related Topics

hiCreateHypertextField

hiScrollWindowToName

Return to top