Open topic with navigation
Displaying Action Data on the Progress Dialog
InstallShield 2015
Project: This information applies to the following project types:
In InstallScript MSI installations, the action data cannot be displayed on the progress dialog (that is, the STATUSEX dialog). However, you can call Enable (INDVFILESTATUS) in your InstallScript to achieve a similar result. If you call the INDVFILESTATUS constant with the Enable function, the STATUSEX dialog shows the fully qualified file name of each file as it is transferred when FeatureMoveData, CopyFile, or XCopyFile is called and the progress indicator is enabled. Note that if a template is specified for an action in an InstallScript MSI project, the template is written to the installation’s log file.
If you want to provide detailed information about what is occurring as actions are launched at run time, you can add a control to the progress dialog to show action details; the control would need to subscribe to the ActionData event. For example, when the InstallFiles action is executing, the control that shows the action details could include the name, directory, and size of each file as it is being installed on the target system.
To display the action data on the progress dialog:
|
1.
|
On the SetupProgress dialog, add a control that will display the action details: |
|
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: |
ActionData
|
b.
|
In the Text setting, delete the value. |
|
3.
|
Add a subscription for the ActionData 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 ActionData 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 ActionData. For the Attribute field, enter Text. |
At run time, if the installation is run with a full user interface, the progress dialog shows the details of each action as it is launched. If a template has not been defined for an action, the details are not displayed on the progress dialog when that action is launched.
See Also
Enable
Displaying Action Descriptions on the Progress Dialog
Dialogs View (Basic MSI and Other Windows Installer–Based Projects)