The EventMapping Table lists the controls that subscribe to some control events, and lists the attribute to be changed when the event is published by another control or the Windows Installer.
The EventMapping Table has the following columns.
An external key to the first column of the Dialog Table. This field and the Control_ field together identify a control.
An external key to the second column of the Control Table. This field and the Dialog_ field together identify a control.
This field is an identifier that specifies the type of event that is subscribed to by the control. For more information, see ControlEvent Overview.
The name of the Control_ attribute that is set when the event in the Event column is received. The Argument of the event is passed as the argument of the attribute call to change this attribute of the control.
The ControlEvent Table specifies the control events that are started when a user interacts with a PushButton Control, CheckBox Control, or SelectionTree Control. These are the only controls that a user can use to initiate control events.
More than one control on a dialog box can subscribe to the same event.
The following list identifies the typical uses for the EventMapping Table:
- To subscribe a Text Control to an ActionText ControlEvent, ActionData ControlEvent, ScriptInProgress ControlEvent or TimeRemaining ControlEvent published by the Windows Installer.
- To subscribe a ProgressBar Control or Billboard Control to a SetProgress ControlEvent.
- To subscribe a DirectoryCombo Control to an IgnoreChange ControlEvent.
- To automatically disable a PushButton Control located on the same dialog with a SelectionTree Control. To disable the push button when no features are listed in the SelectionTree Control, use the EventMapping Table to subscribe the PushButton control to a SelectionNoItems ControlEvent. Enter Enable in the Attributes field of the EventMapping Table.
- To display a Text Control that shows the path to the installation location for the feature that is selected in a SelectionTree Control on the same dialog. Use the EventMapping Table to subscribe the Text Control to both a SelectionPathOn ControlEvent and SelectionPath ControlEvent published by the SelectionTree Control.
- To display a Text Control that shows a description of the item highlighted in a SelectionTree Control located on the same dialog, use the EventMapping Table to subscribe the Text Control to a SelectionDescription ControlEvent, SelectionSize ControlEvent or SelectionAction ControlEvent. Enter Text in the Attribute field of the EventMapping Table.