Boîtes de dialogue (Windows Installer)

Les boîtes de dialogue sont spécifiées dans la colonne Dialog de la table Dialog. Pour plus d’informations sur l’ajout d’une boîte de dialogue ou d’un panneau d’affichage à une interface utilisateur, consultez Utilisation de l’interface utilisateur.

Noms de boîte de dialogue réservés

Les noms de boîte de dialogue suivants sont réservés par Windows Installer et ne doivent pas être utilisés pour les boîtes de dialogue personnalisées créées par l’utilisateur. Le programme d’installation nécessite que ces boîtes de dialogue soient listées dans la table Dialog en utilisant les noms réservés suivants. Chaque boîte de dialogue et chaque nom ne peuvent être listés qu’une seule fois. Les développeurs doivent créer ces boîtes de dialogue dans l’interface utilisateur. Pour plus d’informations sur l’aperçu des boîtes de dialogue, consultez Importation de l’interface utilisateur.

Nom de la boîte de dialogue Brève description de la boîte de dialogue
Boîte de dialogue FilesInUse Avertit l’utilisateur que des processus remplacent ou suppriment des fichiers.
Boîte de dialogue FirstRun Collecte le nom d’utilisateur, le nom de l’entreprise et l’ID de produit.
Boîte de dialogue MsiRMFilesInUse Avertit l’utilisateur que des processus remplacent ou suppriment des fichiers et donne à l’utilisateur la possibilité d’utiliser le Gestionnaire de redémarrage pour fermer et redémarrer des applications.

 

Boîtes de dialogue obligatoires

Pendant l’installation, certains événements amènent Windows Installer à vérifier les tables de séquences d’interface utilisateur dans le package et à afficher la boîte de dialogue spécifiée. Par exemple, en cas d’erreur irrécupérable, Windows Installer affiche la boîte de dialogue listée avec un numéro séquentiel de -3 dans la table de séquences d’interface utilisateur, quel que soit le nom de cette boîte de dialogue dans la table Dialog. Le tableau suivant liste les événements spécifiques et leur numéro de séquence correspondant dans la table de séquences d’interface utilisateur :

Type d’événement Numéro de séquence dans la table de séquences d’interface utilisateur Description de la boîte de dialogue
Erreur irrécupérable -3 L’installation a été interrompue par une erreur irrécupérable.
Sortie de l’utilisateur -2 L’installation a été arrêtée à la demande de l’utilisateur.
Quitter -1 L’installation s’est terminée avec succès.

 

En outre, l’auteur du package doit créer une boîte de dialogue générique pour afficher les messages d’erreur de Windows Installer. Cette boîte de dialogue peut se voir attribuer n’importe quel nom, mais ce dernier doit être spécifié dans la propriété ErrorDialog.

Boîtes de dialogue classiques

Les boîtes de dialogue suivantes sont facultatives et sont généralement incluses dans l’interface utilisateur créée d’un package d’installation. Ces boîtes de dialogue sont typiques de la plupart des Assistants d’interface utilisateur pour l’installation de fichiers. Ces boîtes de dialogue peuvent avoir n’importe quel nom dans la table Dialog. Les noms indiqués sont recommandés uniquement à des fins de clarté et peuvent être modifiés si nécessaire. Par exemple, deux boîtes de dialogue LicenseAgreement personnalisées différentes peuvent être utilisées dans le package et distinguées dans la table Dialog par les noms ProfessionalLicenseAgreement et LimitedLicenseAgreement.

Type de boîte de dialogue Brève description de la boîte de dialogue
Boîte de dialogue DiskCost Indique un espace disque insuffisant pour l’installation.
Boîte de dialogue Parcourir Permet à l’utilisateur de sélectionner un répertoire.
Boîte de dialogue Annuler Confirme une demande d’arrêt de l’installation.
Boîte de dialogue Contrat de licence Boîte modale affichant le contrat de licence.
Boîte de dialogue Sélection Boîte modale permettant à l’utilisateur de sélectionner des éléments.