Cases à cocher, boîte de dialogue de l'interface utilisateur

Les boîtes de dialogue Cases à cocher proposent à l'utilisateur quatre choix au plus et retournent les valeurs de ces choix durant l'installation. Trois boîtes de dialogue Cases à cocher sont disponibles : Cases à cocher (A), Cases à cocher (B) et Cases à cocher (C). Ces trois boîtes de dialogue sont identiques, chacune ne pouvant être ajoutée qu'une seule fois pour chaque projet de déploiement.

Les boîtes de dialogue contiennent quatre cases à cocher avec des étiquettes associées, plus des étiquettes supplémentaires pour présenter des informations à l'utilisateur. Le texte de ces étiquettes est spécifié au moment du design dans la fenêtre Propriétés. Des propriétés supplémentaires sont fournies pour chaque case à cocher afin de contrôler la visibilité, de définir une valeur par défaut et de retourner une valeur.

L'illustration suivante contient une boîte de dialogue Cases à cocher typique, telle qu'elle apparaît pendant l'installation.

Boîte de dialogue Cases à cocher

Propriétés

Les propriétés ci-après sont disponibles pour la boîte de dialogue Cases à cocher.

Propriété	Description
BannerBitmap	Spécifie une bitmap ou une image JPEG à afficher dans la bannière. Dans l'illustration ci-dessus, il s'agit de la bitmap par défaut. Pour plus d'informations, consultez BannerBitmap, propriété.
BannerText	Spécifie le texte à afficher dans la bannière. Dans l'illustration ci-dessus, le texte correspondant est "Ceci est le texte de la bannière".
BodyText	Spécifie le texte à afficher au-dessus des cases à cocher. Dans l'illustration ci-dessus, le texte correspondant est "Ceci est le corps du texte".
Checkbox1Label	Spécifie le texte à afficher à côté de la première case à cocher. Dans l'illustration ci-dessus, le texte correspondant est "Sélection n° 1".
Checkbox1Property	Spécifie le nom de propriété utilisé pour récupérer la valeur (Checked ou Unchecked) de la première case à cocher. Cette propriété peut être utilisée dans des conditions.
Checkbox1Value	Spécifie la valeur initiale (Checked ou Unchecked) de la première case à cocher.
Checkbox1Visible	Spécifie si la première case à cocher est affichée ou masquée. Elle doit avoir la valeur true pour une boîte de dialogue affichant au moins une case à cocher.
Checkbox2Label	Spécifie le texte à afficher à côté de la deuxième case à cocher. Dans l'illustration ci-dessus, le texte correspondant est "Sélection n° 2".
Checkbox2Property	Spécifie le nom de propriété utilisé pour récupérer la valeur (Checked ou Unchecked) de la deuxième case à cocher. Cette propriété peut être utilisée dans des conditions.
Checkbox2Value	Spécifie la valeur initiale (Checked ou Unchecked) de la deuxième case à cocher.
Checkbox2Visible	Spécifie si la deuxième case à cocher est affichée ou masquée. Elle doit avoir la valeur true pour une boîte de dialogue affichant au moins deux cases à cocher, ou false pour une boîte de dialogue affichant une seule case à cocher.
Checkbox3Label	Spécifie le texte à afficher à côté de la troisième case à cocher. Dans l'illustration ci-dessus, le texte correspondant est "Sélection n° 3".
Checkbox3Property	Spécifie le nom de propriété utilisé pour récupérer la valeur (Checked ou Unchecked) de la troisième case à cocher. Cette propriété peut être utilisée dans des conditions.
Checkbox3Value	Spécifie la valeur initiale (Checked ou Unchecked) de la troisième case à cocher.
Checkbox3Visible	Spécifie si la troisième case à cocher est affichée ou masquée. Elle doit avoir la valeur true pour une boîte de dialogue affichant au moins trois cases à cocher, ou false pour une boîte de dialogue affichant au plus deux cases à cocher.
Checkbox4Label	Spécifie le texte à afficher à côté de la quatrième case à cocher. Dans l'illustration ci-dessus, le texte correspondant est "Sélection n° 4".
Checkbox4Property	Spécifie le nom de propriété utilisé pour récupérer la valeur (Checked ou Unchecked) de la quatrième case à cocher. Cette propriété peut être utilisée dans des conditions.
Checkbox4Value	Spécifie la valeur initiale (Checked ou Unchecked) de la quatrième case à cocher.
Checkbox4Visible	Spécifie si la quatrième case à cocher est affichée ou masquée. Elle doit avoir la valeur true pour une boîte de dialogue affichant quatre cases à cocher, ou false pour une boîte de dialogue affichant au plus trois cases à cocher.

Contrôle de l'aspect de la boîte de dialogue Cases à cocher

Plusieurs propriétés contrôlent comment la boîte de dialogue Cases à cocher apparaît à l'utilisateur pendant l'installation.

• La propriété BannerBitmap contrôle l'image qui s'affiche dans le coin supérieur droit de la boîte de dialogue. La position et la taille de l'image sont fixes.

  Conseil

  Pour bénéficier d'une interface utilisateur cohérente, la même image doit être utilisée pour toutes les boîtes de dialogue d'un programme d'installation.

• La propriété BannerText contrôle le texte affiché dans la bannière en haut de la boîte de dialogue. La position, la taille et la taille de la police sont fixes. Le texte peut être automatiquement renvoyé à la ligne, mais il ne peut excéder deux lignes.

• La propriété BodyText contrôle le texte affiché juste en dessous de la bannière de la boîte de dialogue. La position et la taille de la police sont fixes. Le texte peut être automatiquement renvoyé à la ligne, mais il ne peut excéder quatre lignes.

• Les propriétés CheckboxNLabel contrôlent le texte des étiquettes des cases à cocher. La position, la taille et la taille de la police sont fixes, et le texte ne peut pas être renvoyé à la ligne.

  Conseil

  Pour les boîtes de dialogue susceptibles d'être localisées, pensez à prévoir des espaces supplémentaires, sans quoi la traduction d'un texte risque d'être tronquée, les mots n'ayant pas tous la même longueur selon les langues.

Récupération des choix utilisateur avec les propriétés de la boîte de dialogue Cases à cocher

Quand le programme d'installation contenant la boîte de dialogue Cases à cocher est exécuté, l'utilisateur peut modifier la valeur de toutes les cases à cocher affichées ; vous pouvez alors utiliser ce choix pour contrôler une autre phase de l'installation.

Par exemple, vous pouvez créer une boîte de dialogue Cases à cocher qui donne à l'utilisateur le choix de l'installation de deux fichiers facultatifs, File A et File B. Dans ce cas, définissez la propriété Checkbox1Label à "Install File A" et la propriété Checkbox2Label à "Install File B". Vous devez aussi affecter aux propriétés Checkbox3Visible et Checkbox4Visible la valeur false, étant donné que vous n'avez besoin que de deux cases à cocher.

Si vous estimez que les utilisateurs voudront généralement installer le fichier A, vous pouvez affecter à la propriété Checkbox1Value la valeur Checked afin qu'elle soit activée par défaut.

Dans l'Éditeur du système de fichiers, vous pouvez affecter la valeur de la propriété Checkbox1Property à la propriété Condition du fichier A, et la valeur de la propriété Checkbox2Property à la propriété Condition du fichier B.

Pendant l'installation, la propriété Condition de chaque fichier sera évaluée. Si l'utilisateur active la case à cocher, la condition prendra la valeur true et le fichier sera installé ; sinon, il ne sera pas installé.

Voir aussi

Concepts

Restrictions sur les boîtes de dialogue d'installation

Autres ressources

Gestion de l'interface utilisateur lors d'un déploiement

Boîtes de dialogue du déploiement

Gestion des conditions de lancement lors d'un déploiement