Windows
Installer documentation| Reference information | |
|---|---|
| Project page | Dialogs and Billboards |
| Related topics | Working with attribute panes |
| External links | Windows
Installer documentation |
A Control Event is an installer action that is executed when the user clicks a CheckBox, PushButton, or SelectionTree control (control events for the last one are only supported by recent versions of Windows Installer). The action can be a standard event action, an assignment of a property value, or a custom action similar to those executed in action sequences.
Control events are typically used to transfer control to the next or previous dialog box in the installer's user interface sequence; this is accomplished by defining NewDialog control events for the Next and Back PushButtons in a dialog box. Other uses include opening secondary dialog boxes (for example, the BrowseDlg dialog box is opened by a control event for the Browse... button on the CustomizeDlg dialog box) or data validation.
You can define multiple control events for a control; they will be executed in the order in which they appear on the Event handlers tab page of the Dialogs and Billboards project page.
Implementation note: In the Windows Installer documentation, "Control Event" refers to the standard event actions, custom actions are performed by the DoAction control event, and properties are set by using a special "[property_name]" syntax. In Tarma ExpertInstall, these are all unified under Control Events. The standard Windows Installer control events are marked Standard Event, while the others use their normal action names.
Tarma Installer uses generalized Event
Handlers that can execute any standard or custom action. Tarma event handlers
can be attached to almost any control type and to a wider range of user interaction
events than Windows Installer supports.
This pane contains the following attributes and options.
| Attribute | Description |
|---|---|
| Action name | Enter the name of the predefined control event to generate when the control is clicked, or click ... (browse) to open the Select Control Event dialog box that displays the list of available control events for the control. |
| Argument |
Enter the argument for the selected action. For example, for a NewDialog action, you must specify the dialog box name to be opened. |
| Condition |
Enter the condition for the control event as a conditional expression. The action will only be executed if this condition evaluates to true. Tip: For the SpawnWaitDialog action, the condition is also used to close the wait dialog box; it will be shown as long as the condition remains true. For other actions, the condition only determines if the action is executed. |