Show Message Dialog Action

InstallAnywhere 2018

Te Show Message Dialog action creates a modal dialog that requests end-user input. The message dialog appears over the currently displayed panel.

You can use this action to force the end user to return to the previous panel, exit the installer, or enter information. When controlled by rules, the message dialog can also serve as a data verification tool.

The following options are included:

Show Message Dialog Options

Option

Description

Title

Enter the text that will appear in the title bar of the message dialog.

Label

Enter the title of the message dialog that will appear in bold above the message text.

Message

Enter the text of the message you want to display on the dialog. You may enter as much text as you feel is necessary; the dialog will expand to display all of the text that you enter.

Dialog Type

Select one of the following options to specify which icon you want to display on this message dialog: Warning, Error, Information, or Query.

Cancel and Exit on ESC or X

If you want the installer to cancel and exit the installation if the end user presses the Escape button or clicks the Close button (X) on the message dialog, select this check box.

This check box is cleared by default.

Button 0, 1, 2

Specify whether you want to include an OK and Cancel button on this message dialog, and set the names of those buttons. An OK button is required. For each of these buttons, specify the action to take when the button is clicked: Return to Previous Panel, Continue to Next, or Cancel and Exit.

Button 2

Select this option if you want to include a button that will open another dialog containing more detailed information, depending upon the action the user takes on this dialog. By default, the name of this button is Details...

To specify which dialog box would be displayed when the user clicks Details, you would add an additional dialog that has a Compare InstallAnywhere Variables rule applied to it which would check for the value of the Results Variable defined on this Show Message Dialog.

Also, specify the action to take when the button is clicked: Return to Previous Panel, Continue to Next, or Cancel and Exit.

Note • If you add a Show Message Dialog to the Pre-Install, Post-Install, Pre-Uninstall, or Post-Uninstall phase, the Return to Previous Panel option is enabled. If a Show Message Dialog is added to the Install or Uninstall sequence, Return to Previous Panel will be disabled.

Results Variable

This variable is used to collect the results of the user action on the Show Message Dialog. For example, if the variable is set to $CHOSEN_DIALOG_BUTTON$, the value of this variable would vary depending upon which action the user takes:

Next—If the user clicks Next, the variable would be set to 0.
Previous—If the user clicks Previous, the variable would be set to 1.
Details—If the user clicks Details, the variable would be set to 2.