Jumps

Jumps link related topics together. By clicking a specially coded word, phrase, or bitmap, the user can move instantly to another related topic.

In the Title

Jump text appears underlined and in a different color in the Viewer window. The default color is green, but users can set this color by assigning RGB values to the JumpColor option in the [Viewer section of the Windows WIN.INI file. Authors can create jumps so they are invisible in the topic.

Whenever the mouse pointer moves over the hot spot, the pointer changes shape from an arrow to a pointing finger. This pointer change can also be used to identify invisible hot spots in the title. In the following example, the jump appears at the underlined text “Phoenix”:

In the Topic File

The coding for a jump has two parts:

A reference word or phrase formatted as double-underline text

The context string that identifies the destination topic formatted as hidden text

The following example shows how this might look in the topic file:

Phoenixaz_capital

RTF Format

{\uldb hot-spot text}{\v [%]destination-context-string[>secondary-window-type]}

Parameters

hot-spot text

Hot-spot text or hot bitmap reference. When the user clicks this text or bitmap, Viewer jumps to the topic indicated by the immediately following context string. See “Bitmaps (16 Colors),” later in this chapter, for more information on coding for bitmap references.

destination-context-string

Context string of the topic Viewer jumps to. If a percent sign (%) is the first character in this context string, the hot spot is invisible in the topic.

secondary-window-type

This entry is optional. If the destination topic is displayed in a secondary window, this entry specifies the type of the secondary window. The description for this type of secondary window is given in the [WINDOWS] section of the project file. See Chapter 17, “Project File Fornat,” for information on the [WINDOWS] section of the project file.

Example

The following example shows the RTF for the jump example shown earlier. It inserts a jump to the topic with context string “Phoenix.” The text “Phoenix” in the topic becomes the hot spot for the jump:

{\uldb (Phoenix)}{\v az_capital}