Table EventMapping
La table EventMapping liste les contrôles qui s’abonnent à des événements de contrôle, et liste l’attribut de contrôle à changer quand l’événement est publié par un autre contrôle ou Windows Installer.
La table EventMapping a les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Dialog_ | Identificateur | O | N |
| Control_ | Identificateur | O | N |
| Événement | Identificateur | O | N |
| Attribut | Identificateur | N | N |
Colonnes
-
Dialog_
-
Clé externe de la première colonne de la table Dialog. Ce champ et le champ Control_ identifient ensemble un contrôle.
-
Control_
-
Clé externe de la deuxième colonne de la table Control. Ce champ et le champ Dialog_ identifient ensemble un contrôle.
-
Event
-
Ce champ est un identificateur qui spécifie le type d’événement auquel est abonné le contrôle. Pour plus d’informations, consultez Vue d’ensemble de ControlEvent.
-
Attribute
-
Nom de l’attribut Control_ défini à la réception de l’événement dans la colonne Event. L’argument de l’événement est passé comme argument de l’appel d’attribut pour changer cet attribut du contrôle.
Notes
La table ControlEvent spécifie les événements de contrôle démarrés quand un utilisateur interagit avec un contrôle PushButton, un contrôle CheckBox ou un contrôle SelectionTree. Il s’agit des seuls contrôles que l’utilisateur peut utiliser pour lancer des événements de contrôle.
Plusieurs contrôles d’une boîte de dialogue peuvent s’abonner au même événement.
La liste suivante identifie les utilisations classiques de la table EventMapping :
- Pour abonner un contrôle Text à un ControlEvent ActionText, ControlEvent ActionData, ControlEvent ScriptInProgress ou ControlEvent TimeRemaining publié par Windows Installer.
- Pour abonner un contrôle ProgressBar ou un contrôle Billboard à un ControlEvent SetProgress.
- Pour abonner un contrôle DirectoryCombo à un ControlEvent IgnoreChange.
- Pour désactiver automatiquement un contrôle PushButton situé dans la même boîte de dialogue qu’un contrôle SelectionTree. Pour désactiver un PushButton quand aucune fonctionnalité n’est listée dans le contrôle SelectionTree, utilisez la table EventMapping pour abonner le contrôle PushButton à un ControlEvent SelectionNoItems. Entrez Enable dans le champ Attributes de la table EventMapping.
- Pour afficher un contrôle Text qui affiche le chemin de l’emplacement d’installation de la fonctionnalité sélectionnée dans un contrôle SelectionTree dans la même boîte de dialogue. Utilisez la table EventMapping pour abonner le contrôle Text à un ControlEvent SelectionPathOn et à un ControlEvent SelectionPath publié par le contrôle SelectionTree.
- Pour afficher un contrôle Text qui affiche une description de l’élément sélectionné dans un contrôle SelectionTree situé dans la même boîte de dialogue, utilisez la table EventMapping pour abonner le contrôle Text à un ControlEvent SelectionDescription, un ControlEvent SelectionSize ou un ControlEvent SelectionAction. Entrez Text dans le champ Attribute de la table EventMapping.
Validation