Zones de texte, boîte de dialogue de l'interface utilisateur

Article
08/10/2011

Les boîtes de dialogue Zones de texte proposent à l'utilisateur quatre zones de texte au plus et retournent le contenu de ces champs durant l'installation. Trois boîtes de dialogue Zones de texte sont disponibles : Zones de texte (A), Zones de texte (B) et Zones de texte (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 zones de texte avec des étiquettes, 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 zone de texte afin de contrôler la visibilité, de définir un texte par défaut et de retourner une valeur.

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

Boîte de dialogue Zones de texte

Écran de démarrage de l'interface utilisateur de déploiement

Propriétés

Les propriétés ci-après sont disponibles pour la boîte de dialogue Zones de texte.

Propriété	Description
BannerBitmap	Spécifie une bitmap ou une image JPEG à afficher dans la bannière. Dans l'illustration précédente, 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 précédente, le texte correspondant est "Ceci est le texte de la bannière".
BodyText	Spécifie le texte à afficher au-dessus des zones de texte. Dans l'illustration précédente, le texte correspondant est "Ceci est le corps du texte".
Edit1Label	Spécifie le texte à afficher au-dessus de la première zone de texte. Dans l'illustration précédente, le texte correspondant est "Champ d'entrée n°1".
Edit1Property	Spécifie le nom de propriété utilisé pour récupérer le texte entré dans la première zone de texte. Cette propriété peut être utilisée dans des conditions.
Edit1Value	Spécifie la valeur initiale (texte) de la première zone de texte.
Edit1Visible	Spécifie si la première zone de texte est affichée ou masquée. Elle doit avoir la valeur true pour une boîte de dialogue affichant au moins une zone de texte.
Edit2Label	Spécifie le texte à afficher au-dessus de la deuxième zone de texte. Dans l'illustration précédente, le texte correspondant est "Champ d'entrée n°2".
Edit2Property	Spécifie le nom de propriété utilisé pour récupérer le texte entré dans la deuxième zone de texte. Cette propriété peut être utilisée dans des conditions.
Edit2Value	Spécifie la valeur initiale (texte) de la deuxième zone de texte.
Edit2Visible	Spécifie si la deuxième zone de texte est affichée ou masquée. Elle doit avoir la valeur true pour une boîte de dialogue affichant au moins deux zones de texte, ou false pour une boîte de dialogue affichant une seule zone de texte.
Edit3Label	Spécifie le texte à afficher au-dessus de la troisième zone de texte. Dans l'illustration précédente, le texte correspondant est "Champ d'entrée n°3".
Edit3Property	Spécifie le nom de propriété utilisé pour récupérer le texte entré dans la troisième zone de texte. Cette propriété peut être utilisée dans des conditions.
Edit3Value	Spécifie la valeur initiale (texte) de la troisième zone de texte.
Edit3Visible	Spécifie si la troisième zone de texte est affichée ou masquée. Elle doit avoir la valeur true pour une boîte de dialogue affichant au moins trois zones de texte, ou false pour une boîte de dialogue affichant au plus deux zones de texte.
Edit4Label	Spécifie le texte à afficher au-dessus de la quatrième zone de texte. Dans l'illustration précédente, le texte correspondant est "Champ d'entrée n°4".
Edit4Property	Spécifie le nom de propriété utilisé pour récupérer le texte entré dans la quatrième zone de texte. Cette propriété peut être utilisée dans des conditions.
Edit4Value	Spécifie la valeur initiale (texte) de la quatrième zone de texte.
Edit4Visible	Spécifie si la quatrième zone de texte est affichée ou masquée. Elle doit avoir la valeur true pour une boîte de dialogue affichant quatre zones de texte, ou false pour une boîte de dialogue affichant au plus trois zones de texte.

Contrôle de l'aspect de la boîte de dialogue Zones de texte

Plusieurs propriétés contrôlent comment la boîte de dialogue Zones de texte 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, la taille 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 EditNLabel contrôlent le texte des étiquettes des zones de texte. La position 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 informations utilisateur à l'aide des propriétés de la boîte de dialogue Zones de texte

Lorsque le programme d'installation qui contient la boîte de dialogue Zones de texte est exécuté, l'utilisateur peut entrer des informations dans toute zone de texte visible. Vous pouvez utiliser ensuite ces informations dans une autre phase d'installation.

Par exemple, vous pouvez créer une boîte de dialogue Zones de texte qui permet à l'utilisateur d'entrer le nom du groupe de travail à stocker dans une entrée du Registre. Dans ce cas, affectez à la propriété Edit1Label la valeur "Entrer votre nom de groupe de travail". Vous devez aussi affecter aux propriétés Edit2Visible, Edit3Visible et Edit4Visible la valeur False, car vous n'avez besoin que d'une seule zone de texte.

Si vous pensez que les utilisateurs souhaiteront utiliser un groupe de travail nommé « Default », vous pouvez entrer Default dans la propriété Edit1Value. Ce sera l'entrée initiale que l'utilisateur voit dans la zone de texte.

Dans le Registre, affectez la valeur de la propriété Edit1Property à la propriété Condition correspondant à l'entrée de Registre du nom du groupe de travail ; par exemple, [EDITA1].

Pendant l'installation, la propriété Condition est évaluée. Si l'utilisateur saisit un nom (ou accepte le nom par défaut), ce nom est ajouté au Registre ; s'il est vide, aucune entrée n'est créée dans le Registre.

Définition de la condition et de la valeur des actions personnalisées gérées

Lorsque vous créez une interface utilisateur pour une action personnalisée gérée, vous pouvez définir la condition et la valeur. Toutefois, vous ne pouvez utiliser la condition et la valeur qu'en fonction des propriétés des éléments d'interface personnalisés. Les actions personnalisées s'exécutent une fois le programme d'installation terminé, vous ne pouvez donc pas utiliser de propriétés du projet d'installation.