Previous Topic: LabelNext Topic: Password Field


Navigation Button

PIF dialog editor toolbox icon for Navigation button

A navigation button specifies the next installation dialog to appear and lets you initiate different actions. A shell script can be specified that determines the next installation dialog. You can drag and drop navigation buttons from the toolbox only into the navigation area at the bottom of the workbox.

The following table includes the actions that can be associated with a navigation button:

Action

Description

Action Number

Cancel

Aborts the installation

0

Install

Installs the product

1

Next dialog

Starts the next dialog

Note: The name of the next dialog must be defined in the "Next dialog" field.

2

Remove

Removes the installed product

3

Previous dialog

Returns to the previous dialog

4

Dynamic dialog

Determines the name of the next dialog by executing a shell script, and starts that dialog

Note: The name of the script must be defined in the "script" field.

5

Start script

End the Installer GUI and start a user script

Note: The name of the script must be defined in the "script" field.

6

Goto

Jumps to another dialog and takes over the origin of that dialog, that is, the Back button (previous dialog) will lead to the predecessor dialog of that new dialog.

Note: The name of the target dialog must be defined in the “Next dialog” field.

7

Start script and continue

Closes the current dialog, starts the specified script, and starts the initial dialog again.

Note: The name of the script must be defined in the “script” field.

8

Execute script

(Button only)

Executes the specified script and shows the result in the specified result pane. The result pane can be a progress area or a text area.

9

When creating installation dialogs, you can define four navigation buttons in the navigation area. To visualize their function, you can specify text or an icon that appears on the button. When you choose the Dynamic dialog action, you must specify the script to use.

In the prototype file, use the #navbutton keyword in the Dialog section to define a navigation button. On the Packager GUI, you specify navigation buttons in the Navigation button properties dialog.

In the button text string, you can use the ampersand (&) character to define a shortcut. The ampersand character precedes that character, which can be used as shortcut, for example, if you write Ne&xt as the button text, the small letter x is the defined shortcut. By default, the first character of the text string serves as the shortcut. The button text string must not contain any control character, such as CR (carriage return) or LF (line feed).

You must define at least one Cancel dialog for each navigation button that has the Cancel action associated.

Important! Shortcut keys in installation dialogs do not work, if you execute the installation dialogs in a Common Desktop Environment (CDE) session of HP-UX systems of Versions 11.0 and 11.i.