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.
Control Event
Select the desired control event from the list.
This 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:
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.
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 to run correctly. The specified dialog is shown 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.