Displaying Action Descriptions on the Progress Dialog

InstallShield 2015

Project: This information applies to the following project types:

Basic MSI
InstallScript MSI
MSI Database
Transform

In InstallScript MSI installations, the action text is automatically displayed on the progress dialog (that is, the STATUSEX dialog) if the dialog is enabled through a call to Enable (STATUSEX). This dialog is not available for editing.

By default, if a description has been specified for an action in your installation, that description is displayed above the progress bar on the progress dialog. Therefore, unless you have made some changes to this dialog in your project, you do not need to perform the following steps.

To display action descriptions on the progress dialog:

1. On the SetupProgress dialog, add a control that will display the action description:
a. In the View List under User Interface, click Dialogs.
b. In the Dialogs explorer, expand the All Dialogs folder, and then expand the SetupProgress dialog.
c. Click a language under the SetupProgress dialog. The Dialog Editor in the center pane shows the dialog in the selected language.
d. In the Controls toolbar, click the Text Area control.
e. Draw a rectangle on the dialog in the location where you want the action description to be displayed.
2. With the control selected, configure its settings in the right pane:
a. For the (Name) setting, enter the following:

ActionText

b. In the Text setting, delete the value.
3. Add a subscription for the ActionText event to the new control:
a. In the Dialogs explorer under the SetupProgress dialog, click the Behavior item. The grid in the center pane shows all of the controls on the SetupProgress dialog.
b. Select the ActionText control that you just created, and then click the Subscriptions tab in the lower-right pane.
c. In the upper-right pane, add a record with the following information: For the Event field, select ActionText. For the Attribute field, enter Text.

At run time, if the installation is run with a full or reduced user interface, the progress dialog shows the description of each action as it is encountered. If a description has not been defined for an action, no description is displayed on the progress dialog when that action is launched.

See Also