ScriptInProgress ControlEvent

The installer uses this event to display an informational string while the installation's execution script is being compiled. The informational string can be displayed on a dialog box by a Text Control that subscribes to this ControlEvent. This event should be authored in the EventMapping table.

This ControlEvent can be handled by a user interface run at the basic UI, reduced UI, or full UI levels. For information about UI levels, see User Interface Levels.

Published By

This ControlEvent is published by the installer.

Argument

None.

Action on Subscribers

A Text control subscribing to ScriptInProgress will display text string specified in UIText table.

Typical Use

While the execution script is being compiled, the installer displays a ProgressBar indicating the time remaining before the beginning of script execution. The package author can display a preliminary message at this time explaining the ProgressBar. To display a preliminary message, include a Text control on the same modeless dialog box as the ProgressBar. Specify that this Text control subscribe to the ScriptInProgress ControlEvent via the EventMapping table. Include an entry in the UIText table with ScriptInProgress specified in the Key field. Specify the preliminary message as a text string in the Text field of the UIText table. Then during script compilation, the installer will display this string within the text control. The displayed text disappears as soon as the script compilation is finished.

The same text control that subscribes to the ScriptInProgress ControlEvent can also subscribe to the TimeRemaining ControlEvent. In this case, as text of the preliminary ScriptInProgress string disappears, it is replaced by the "Time Remaining: xx minutes" string.