Edit Control Events Dialog

This dialog allows you to edit a control event. A control event is an action that is triggered when the user interacts with the control.

Edit Control Event Dialog

Control Event

Select the desired control event from the list.

NoteThis list contains only the events supported by the selected control.

Event Options

This section allows you to set the selected event's options.

Argument

Specify an argument for the control event. For some events there is a list of arguments from which you can choose, for others this field is of Formatted Type. Use the [ ... ] button to display the Edit Formatted Type Dialog that will allow you to insert a reference to a property. Also some events may not need arguments.

Condition

Specify an execution condition for the control event. Edit this field using Smart Condition Edit Control.

The control events created in Advanced Installer can use these predefined conditions:

  • 1 - this condition is always true; usually it's used by control events on the secondary dialogs (dialogs which have a parent dialog) and on "Special Dialogs"
  • AI_INSTALL - true during the first installation of a package; usually it's used by control events on "First Time Install" primary dialogs (dialogs which do not have a parent dialog)
  • AI_MAINT - true when the package is in Maintenance mode; usually it's used by control events on "Maintenance" dialogs
  • AI_PATCH - true during a patch installation; usually it's used by control events on "Patch" dialogs

Show entire condition option will reveal these predefined conditions.

Examples of commonly used control conditions:

A Display a specific dialog control events is used to close one modal dialog box and open another. When a control that publishes this event is triggered, the Installer closes the current dialog and puts up a new one in its place. In the User Interface of your Installer, the Back and Next buttons will publish Display a specific dialog events to enable navigation between the various installation dialogs.

The Display a specific child dialog event also opens a new modal dialog box. The difference between the "Display a specific dialog" and "Display a specific child dialog" events is that the latter does not destroy the current dialog. The Display a child dialog while a condition is true event also opens a new modal dialog without closing the current one. This control event requires a condition in order to run correctly. The specified dialog is showed as long as the condition evaluates to True and is destroyed as soon as it evaluates to False. For example, you might use this control event to display a “Please Wait” dialog while the Installer computes component costs before displaying a dialog box with a SelectionTree control.

The "Published Events" tab in the "Dialogs" page of an Enterprise or Architect project allows you to specify the Control Events started when a user interacts with a PushButton Control, CheckBox Control or SelectionTree Control. These are the only controls which can initiate published control events. Each control can publish multiple control events.

The installer starts each event in the order specified in the project. For example, a push button control can publish events to initiate a transition to another dialog box, exit the dialog box sequence, and begin file installation. The exception is that each control can publish at most one "Display a specific dialog" or one "Display a specific child dialog" event. If multiple "Display a specific dialog" and "Display a specific child dialog" control events are selected for the same control, only the last one gets published when the control is activated.