Types de boîte de dialogue courants

La bibliothèque de boîtes de dialogue commune fournit une fonction de création et une structure pour chaque type de boîte de dialogue commune. Pour utiliser une boîte de dialogue commune dans sa forme la plus simple, vous appelez sa fonction de création et spécifiez un pointeur vers une structure qui contient les valeurs initiales et les indicateurs d’option. Après avoir initialisé la boîte de dialogue, la procédure de boîte de dialogue utilise la structure pour retourner des informations sur l’entrée utilisateur. Vous pouvez également personnaliser une boîte de dialogue commune en fonction des besoins de votre application.

Le tableau suivant fournit une brève description des différents types de boîtes de dialogue courantes et montre la fonction et la structure utilisées avec chaque type.

Boîte de dialogue	Description
Color	Affiche les couleurs disponibles et permet éventuellement à l’utilisateur de créer des couleurs personnalisées. L’utilisateur peut sélectionner une couleur de base ou personnalisée. Utilisez la fonction ChooseColor et la structure CHOOSECOLOR . Pour plus d’informations, consultez Boîte de dialogue Couleur.
Rechercher	Affiche une boîte de dialogue dans laquelle l’utilisateur peut taper la chaîne à rechercher. L’utilisateur peut également spécifier des options de recherche, telles que le sens de la recherche et si la recherche respecte la casse. Utilisez la fonction FindText et la structure FINDREPLACE . Pour plus d’informations, consultez Rechercher et remplacer des boîtes de dialogue.
Police	Affiche une boîte de dialogue dans laquelle l’utilisateur peut sélectionner une famille de polices et le style de police associé, les tailles de points et d’autres attributs de police tels que la couleur de police, le soulignement ou le barré. Utilisez la fonction ChooseFont et la structure CHOOSEFONT . Pour plus d’informations, consultez Boîte de dialogue Police.
Ouvrir	Affiche une boîte de dialogue dans laquelle l’utilisateur peut taper ou sélectionner le nom d’un fichier ou d’un objet d’espace de nom d’interpréteur de commandes à ouvrir. La boîte de dialogue comprend des listes de lecteurs, de répertoires et d’extensions d’espace de nom d’interpréteur de commandes qui permettent à l’utilisateur de parcourir l’espace de nom de l’interpréteur de commandes. Il inclut également une liste d’extensions de nom de fichier qui permet à l’utilisateur de filtrer les noms de fichiers affichés. Utilisez la fonction GetOpenFileName et la structure OPENFILENAME . Pour plus d’informations, consultez Ouvrir et enregistrer sous boîtes de dialogue.
Mise en page	Affiche la configuration de la page active. L’utilisateur peut sélectionner des options de configuration de page, telles que l’orientation du papier, la taille, la source et les marges. Utilisez la fonction PageSetupDlg et la structure PAGESETUPDLG . Pour plus d’informations, consultez Boîte de dialogue Mise en page.
Imprimer	Affiche des informations sur l’imprimante installée et sa configuration. L’utilisateur peut sélectionner des options de travail d’impression, telles que la plage de pages à imprimer et le nombre de copies, et démarrer le processus d’impression. Utilisez la fonction PrintDlg et la structure PRINTDLG . Pour plus d’informations, consultez Boîte de dialogue Imprimer. Pour afficher une feuille de propriétés Imprimer plutôt qu’une boîte de dialogue Imprimer , utilisez la fonction PrintDlgEx avec la structure PRINTDLGEX . La page Général de la feuille de propriétés est similaire à la boîte de dialogue Imprimer . La feuille de propriétés peut avoir des pages de propriétés supplémentaires spécifiques à l’application et au pilote après la page Général . Pour plus d’informations, consultez Imprimer la feuille de propriétés.
Replace	Affiche une boîte de dialogue dans laquelle l’utilisateur peut taper la chaîne à rechercher et la chaîne de remplacement. L’utilisateur peut spécifier les options de recherche, par exemple si la recherche respecte la casse, et les options de remplacement, telles que l’étendue du remplacement. Utilisez la fonction ReplaceText et la structure FINDREPLACE . Pour plus d’informations, consultez Rechercher et remplacer des boîtes de dialogue.
Enregistrer sous	Affiche une boîte de dialogue dans laquelle l’utilisateur peut taper ou sélectionner le nom avec lequel enregistrer un fichier ou un objet d’espace de nom d’interpréteur de commandes. La boîte de dialogue comprend des listes de lecteurs, de répertoires et d’extensions d’espace de nom d’interpréteur de commandes qui permettent à l’utilisateur de parcourir l’espace de nom de l’interpréteur de commandes. Il inclut également une liste d’extensions de nom de fichier qui permet à l’utilisateur de filtrer les noms de fichiers affichés. Utilisez la fonction GetSaveFileName et la structure OPENFILENAME . Pour plus d’informations, consultez Ouvrir et enregistrer sous boîtes de dialogue.

Bien qu’une boîte de dialogue Configuration d’impression soit disponible, elle a été remplacée par la boîte de dialogue Mise en page. Les applications doivent utiliser la boîte de dialogue Mise en page plutôt que la boîte de dialogue Configuration d’impression .

Toutes les boîtes de dialogue courantes sont modales, à l’exception des boîtes de dialogue Rechercher et Remplacer . Les boîtes de dialogue modales doivent être fermées par l’utilisateur avant que la fonction utilisée pour créer la boîte de dialogue puisse retourner. Les boîtes de dialogue Rechercher et Remplacer sont sans mode ; la fonction retourne avant la fermeture de la boîte de dialogue. Si vous utilisez les boîtes de dialogue Rechercher et remplacer, vous devez également utiliser la fonction IsDialogMessage dans la boucle de message main de votre application pour vous assurer que ces boîtes de dialogue traitent correctement l’entrée du clavier, telles que les touches TAB et Échap.