ControlEvent Table

La table ControlEvent permet à l’auteur de spécifier les événements de contrôle démarrés lorsqu’un utilisateur interagit avec un contrôle PushButton, CheckBox Control ou SelectionTree Control. Il s’agit des seuls contrôles que les utilisateurs peuvent utiliser pour lancer des événements de contrôle. Chaque contrôle peut publier plusieurs événements de contrôle. Le programme d’installation démarre chaque événement dans l’ordre spécifié dans la colonne Classement. Par exemple, un contrôle de bouton Push peut publier des événements pour lancer une transition vers une autre boîte de dialogue, quitter la séquence de boîtes de dialogue et commencer l’installation du fichier.

L’exception à noter est que chaque contrôle peut publier un nouvel événement NewDialog ou SpawnDialog . Si vous devez créer plusieurs événements de contrôle NewDialog et SpawnDialog dans ce tableau, incluez également des instructions conditionnelles dans les champs Condition qui garantissent qu’au plus un événement est publié. Si plusieurs événements de contrôle NewDialog et SpawnDialog sont sélectionnés pour le même contrôle, seul l’événement dont la valeur est la plus élevée dans la colonne Ordering est publiée lorsque le contrôle est activé.

La table ControlEvent contient les colonnes suivantes.

Colonne Type Clé Nullable
Dialog_ Identificateur O N
Control_ Identificateur O N
Événement Formaté O N
Argument Formaté O N
Condition Condition O O
Classement Integer N O

 

Colonnes

Dialog_

Clé externe à la première colonne de la table dialogue. La combinaison de ce champ avec le champ Control_ identifie un contrôle unique.

Control_

Clé externe à la deuxième colonne de la table Contrôle. La combinaison de ce champ avec le champ Dialog_ identifie un contrôle unique.

Événement

Identificateur qui spécifie le type d’événement qui doit avoir lieu lorsque l’utilisateur interagit avec le contrôle spécifié par Dialog_ et Control_. Pour obtenir la liste des valeurs possibles, consultez Vue d’ensemble de ControlEvent.

Pour définir une propriété avec un contrôle, placez [Property_Name] dans ce champ et la nouvelle valeur dans le champ d’argument. Placez { } dans le champ d’argument pour entrer la valeur Null.

Argument

Valeur utilisée comme modificateur lors du déclenchement d’un événement particulier.

Par exemple, l’argument de NewDialog ControlEvent ou de SpawnDialog ControlEvent est le nom de la boîte de dialogue et l’argument de l’action Installer est un nombre définissant le niveau d’installation.

Condition

Instruction conditionnelle qui détermine si le programme d’installation active l’événement dans la colonne Événement. Le programme d’installation déclenche l’événement si l’instruction conditionnelle dans le champ Condition prend la valeur True. Par conséquent, placez un 1 dans cette colonne pour vous assurer que le programme d’installation déclenche l’événement. Le programme d’installation ne déclenche pas l’événement si le champ Condition contient une instruction qui prend la valeur False. Le programme d’installation ne déclenche pas d’événement avec un champ Condition vide, sauf si aucun autre événement du contrôle n’a la valeur True. Si aucun des champs Condition du contrôle nommé dans le champ Control_ a la valeur True, le programme d’installation déclenche l’événement ayant un champ Condition vide et si plusieurs champs Condition sont vides, il déclenche l’événement dont la valeur est la plus élevée dans le champ Classement. Consultez la syntaxe de l’instruction conditionnelle.

Commande

Entier utilisé pour classer plusieurs événements liés au même contrôle. Il doit s’agir d’un nombre non négatif. Ce champ peut être vide.

Notes

La table EventMapping répertorie les contrôles qui s’abonnent à un événement de contrôle et répertorie l’attribut de contrôle à modifier lorsque cet événement est publié par un autre contrôle ou le programme d’installation.

Sur Windows systèmes d’exploitation XP ou antérieurs, les utilisateurs peuvent publier un événement de contrôle uniquement en interagissant avec un contrôle Case à cocher ou un contrôle Pushbutton. Avec Windows Server 2003, les utilisateurs peuvent publier un événement de contrôle uniquement en interagissant avec un contrôle Case à cocher, SelectionTree Control et Pushbutton Control. La liste d’autres contrôles dans le champ Control_ n’a aucun effet.

Validation

ICE03
ICE06
ICE17
ICE20
ICE32
ICE44
ICE46
ICE79
ICE86