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, un contrôle CheckBox ou un contrôle SelectionTree. 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 pousseur peut publier des événements pour lancer une transition vers une autre boîte de dialogue, quitter la séquence de boîte de dialogue et commencer l’installation du fichier.
L’exception à noter est que chaque contrôle peut publier plusieurs événements NewDialog ou SpawnDialog . Si vous devez créer plusieurs événements de contrôle NewDialog et SpawnDialog dans cette table, incluez également des instructions conditionnelles dans les champs Condition qui garantissent qu’au maximum 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 ayant la valeur la plus élevée dans la colonne Ordering est publié lorsque le contrôle est activé.
La table Environment présente les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Dialog_ | Identificateur | O | N |
| Control_ | Identificateur | O | N |
| Événement | Formatted | O | N |
| Argument | Formatted | O | N |
| Condition | Condition | O | O |
| Classement | Integer | N | O |
Colonnes
-
Dialog_
-
Clé externe de la première colonne de la table Dialog. La combinaison de ce champ avec le champ Control_ identifie un contrôle unique.
-
Control_
-
Clé externe de la deuxième colonne du tableau de 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 une 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 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 une valeur 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 vide dans le champ Condition, 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_ prend 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 avec la valeur la plus élevée dans le champ Ordering. ConsultezSyntaxe d’instruction conditionnelle.
-
Classer
-
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 ne peut pas ê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 l’autre contrôle ou le programme d’installation.
Sur Windows XP ou des systèmes d’exploitation antérieurs, les utilisateurs peuvent publier un événement de contrôle uniquement en interagissant avec un contrôle de case à cocher ou un contrôle bouton-pousseur. Avec Windows Server 2003, les utilisateurs peuvent publier un événement de contrôle uniquement en interagissant avec un contrôle De case à cocher, un contrôle SelectionTree et un contrôle pushbutton. La liste des autres contrôles dans le champ Control_ n’a aucun effet.
Validation