This pane allows you to add to a control from the dialog an associated event. There are four types of events that you can use:

  1. Initialization Events
  2. Published Events
  3. Subscribed Events
  4. Control Conditions
  5. Finish Actions
  6. Show ReadMe File
  7. Launch Application

Initialization Events

Dialog initialization events allow you to execute actions (such as setting a property or populating a control from an UI custom action) before the current dialog is displayed.

Adding a new initialization event

Use the [ New... ] button, the “New...” context menu item or press the Insert key while the list is focused. The Edit Control Events Dialog will be displayed allowing you to add a new control event to the list.

Editing an initialization event

Use the [ Edit... ] button, the “Edit...” context menu item or press the Space key while an element is selected. The Edit Control Events Dialog will be displayed allowing you to edit a control event from the list.

Deleting an initialization event

Use the [ Remove ] button, the “Remove” context menu item or press the Delete key while an element is selected.

Changing the execution sequence

Use the [ Up ] / [ Down ] buttons, the “Up” / “Down” context menu items or press the Page Up / Page Down keys while an element is selected.

Published Events

A published control event specifies an action to be taken by the installer or a change in the attributes of one or more controls from a dialog box.

Adding a new published event

Use the [ New... ] button, the “New...” context menu item or press the Insert key while the list is focused. The Edit Control Events Dialog will be displayed allowing you to add a new control event to the list.

Editing a published event

Use the [ Edit... ] button, the “Edit...” context menu item or press the Space key while an element is selected. The Edit Control Events Dialog will be displayed allowing you to edit a control event from the list.

Deleting a published event

Use the [ Remove ] button, the “Remove” context menu item or press the Delete key while an element is selected.

Changing the execution sequence

Use the [ Up ] / [ Down ] buttons, the “Up” / “Down” context menu items or press the Page Up / Page Down keys while an element is selected.

Subscribed Events

The Subscribed Events tab allows you to subscribe the selected control to a list of control events, and lists the attribute to be changed when the event is published by another control or by Windows Installer.

Subscribing to a new event

Use the [ New... ] button, the “New...” context menu item or press the Insert key while the list is selected. The Edit Event Mapping Dialog will be displayed allowing you to subscribe the control to an event.

Editing a subscribed event

Use the [ Edit... ] button, the “Edit...” context menu item or press the Space key while an element is selected. The Edit Event Mapping Dialog will be displayed allowing you to edit an event mapping from the list.

Deleting a subscribed event

Use the [ Remove ] button, the “Remove” context menu item or press the Delete key while an element is selected.

NoteYou can create a commonly used control events or subscribe a control to an event using the “Events Wizard”. You can access it with the “Events Wizard” toolbar button or the “Events Wizard” dialog's context menu item.

Control Conditions

The Control Condition tab allows you to specify special actions to be applied to controls based on the result of a conditional statement.

Adding a new control condition

Use the [ New... ] button, the “New...” context menu item or press the Insert key while the list is focused. The Edit Control Condition Dialog will be displayed allowing you to add a new control condition.

Editing control condition

Use the [ Edit... ] button, the “Edit...” context menu item or press the Space key while an element is selected. The Edit Control Condition Dialog will be displayed allowing you to edit a control condition from the list.

Deleting control condition

Use the [ Remove ] button, the “Remove” context menu item or press the Delete key while an element is selected.

Finish Actions

You can use the Finish Actions tab to schedule two predefined actions that will be executed when the installer ends.

NoteThe tab is available only if ExitDialog is selected in the “Install Sequence” tree.

Show ReadMe File

Show "View ReadMe" option.

Select this option if you want to display the “Show readme file” check box on the ExitDialog.

ReadMe file

Select the file that will be displayed.

Check by default

By default the “Show readme file” box on the dialog is selected.

Launch Application

Launch your application at the end of installation

Select this option if you want to display the “Launch Your Application” check box on the ExitDialog.

Application

Select the file that will be launched.

Arguments

Optionally, you can specify the arguments that will be passed to the application. This field is of Formatted Type and can be edited using Smart Edit Control.

Check by default

By default the “Launch Your Application” box on the dialog is selected.

TipOptionally, you can launch any action at the end of the install process by adding a "UI Custom Action" and for the [ Finish ] button assigning a DoAction event in the Published Events Tab with its argument being equal with the previously created "UI Custom Action". Another method is by adding a custom action under "InstallFinalize" standard action found in "InstallExecuteSequence".

Topics