Types de boîtes 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 sous sa forme la plus simple, vous appelez sa fonction de création et spécifiez un pointeur vers une structure qui contient des valeurs initiales et des 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 pour répondre aux 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
Couleur	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 la 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 Les boîtes de dialogue Rechercher et remplacer.
Font	Affiche une boîte de dialogue dans laquelle l’utilisateur peut sélectionner une famille de polices et un style de police associé, des tailles de point et d’autres attributs de police tels que la couleur de police, le soulignement ou la frappe. Utilisez la fonction ChooseFont et la structure CHOOSEFONT . Pour plus d’informations, consultez la 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 objet d’espace de noms de fichier ou d’interpréteur de commandes à ouvrir. La boîte de dialogue inclut des listes de lecteurs, de répertoires et d’extensions d’espace de noms d’interpréteur de commandes qui permettent à l’utilisateur de parcourir l’espace de noms 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 Les boîtes de dialogue Ouvrir et Enregistrer sous.
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 la boîte de dialogue Mise en page.
Print	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 spécifiques à l’application et spécifiques au pilote supplémentaires en suivant la page Général . Pour plus d’informations, consultez Imprimer la feuille de propriétés.
remplacer	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 des options de recherche, telles que 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 Les boîtes de dialogue Rechercher et remplacer.
enregistrer sous	Affiche une boîte de dialogue dans laquelle l’utilisateur peut taper ou sélectionner le nom avec lequel enregistrer un objet d’espace de noms de fichier ou d’interpréteur de commandes. La boîte de dialogue inclut des listes de lecteurs, de répertoires et d’extensions d’espace de noms d’interpréteur de commandes qui permettent à l’utilisateur de parcourir l’espace de noms 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 Les boîtes de dialogue Ouvrir et Enregistrer sous.

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 principale de votre application pour vous assurer que ces boîtes de dialogue traitent correctement les entrées du clavier, telles que les touches TAB et ÉCHAP.