Bibliothèque de boîtes de dialogue commune

  • Article

La bibliothèque de boîtes de dialogue commune contient un ensemble de boîtes de dialogue permettant d’effectuer des tâches d’application courantes, telles que l’ouverture de fichiers, le choix de valeurs de couleur et l’impression de documents. Les boîtes de dialogue courantes vous permettent d’implémenter une approche cohérente de l’interface utilisateur de votre application. Cela réduit la quantité d’efforts que les utilisateurs consacrent à l’apprentissage du comportement de l’interface utilisateur pour votre application.

Cette section décrit les boîtes de dialogue courantes qui incluent les boîtes de dialogue Ouvrir un fichier et Enregistrer sous ; les boîtes de dialogue Rechercher et remplacer l’édition ; les boîtes de dialogue Imprimer, Configuration d’impression, Feuille de propriétés d’impression et Mise en page ; et les boîtes de dialogue Couleur et Police .

Notes

À compter de Windows Vista, les boîtes de dialogue Ouvrir et Enregistrer sous ont été remplacées par la boîte de dialogue Élément commun. Nous vous recommandons d’utiliser l’API Common Item Dialog au lieu de ces boîtes de dialogue de la bibliothèque de boîtes de dialogue communes.

Dans cette section

Nom Description
Types de boîtes de dialogue courants Décrit les différentes boîtes de dialogue.
Indicateurs d’initialisation de boîte de dialogue courants Explique comment les indicateurs sont utilisés pour modifier le comportement et l’apparence d’une boîte de dialogue commune.
Personnalisation des boîtes de dialogue courantes Explique comment utiliser les boîtes de dialogue courantes.
Utilisation des boîtes de dialogue courantes Couvre les tâches qui appellent des boîtes de dialogue courantes.
Informations de référence sur les boîtes de dialogue courantes Contient la référence d’API.

Fonctions

Nom Description
CCHookProc Reçoit des messages ou des notifications destinés à la procédure de boîte de dialogue par défaut de la boîte de dialogue Couleur . Il s’agit d’une fonction de rappel définie par l’application ou définie par la bibliothèque qui est utilisée avec la fonction ChooseColor .
CFHookProc Reçoit des messages ou des notifications destinés à la procédure de boîte de dialogue par défaut de la boîte de dialogue Police . Il s’agit d’une procédure de rappel définie par l’application ou définie par la bibliothèque qui est utilisée avec la fonction ChooseFont .
ChooseColor Crée une boîte de dialogue Couleur qui permet à l’utilisateur de sélectionner une couleur.
ChooseFont Crée une boîte de dialogue Police qui permet à l’utilisateur de choisir les attributs d’une police logique. Ces attributs incluent une famille de polices et le style de police associé, une taille de point, des effets (soulignement, barré et couleur de texte) et un script (ou jeu de caractères).
CommDlgExtendedError Retourne un code d’erreur de boîte de dialogue commun. Ce code indique l’erreur la plus récente à se produire lors de l’exécution de l’une des fonctions de boîte de dialogue courantes.
FindText Crée une boîte de dialogue Rechercher sans mode définie par le système qui permet à l’utilisateur de spécifier une chaîne à rechercher et les options à utiliser lors de la recherche de texte dans un document.
FRHookProc Reçoit des messages ou des notifications destinés à la procédure de boîte de dialogue par défaut de la boîte de dialogue Rechercher ou remplacer . Il s’agit d’une fonction de rappel définie par l’application ou définie par la bibliothèque qui est utilisée avec la fonction FindText ou ReplaceText .
GetFileTitle Récupère le nom du fichier spécifié.
GetOpenFileName Crée une boîte de dialogue Ouvrir qui permet à l’utilisateur de spécifier le lecteur, le répertoire et le nom d’un fichier ou d’un ensemble de fichiers à ouvrir.
GetSaveFileName Crée une boîte de dialogue Enregistrer qui permet à l’utilisateur de spécifier le lecteur, le répertoire et le nom d’un fichier à enregistrer.
OFNHookProc Reçoit les messages de notification envoyés à partir de la boîte de dialogue. La fonction reçoit également des messages pour tous les contrôles supplémentaires que vous avez définis en spécifiant un modèle de boîte de dialogue enfant. Il s’agit d’une fonction de rappel définie par l’application ou définie par la bibliothèque qui est utilisée avec les boîtes de dialogue Ouvrir et Enregistrer sous de style Explorer.
OFNHookProcOldStyle Reçoit des messages ou des notifications destinés à la procédure de boîte de dialogue. Il s’agit d’une fonction de rappel définie par l’application ou définie par la bibliothèque qui est utilisée avec les boîtes de dialogue Ouvrir et Enregistrer sous .
PagePaintHook Reçoit des messages qui vous permettent de personnaliser le dessin de l’exemple de page dans la boîte de dialogue Mise en page . Il s’agit d’une fonction de rappel définie par l’application ou définie par la bibliothèque utilisée avec la fonction PageSetupDlg .
PageSetupDlg Crée une boîte de dialogue Mise en page qui permet à l’utilisateur de spécifier les attributs d’une page imprimée. Ces attributs incluent le format et la source du papier, l’orientation de la page (portrait ou paysage) et la largeur des marges de page.
PageSetupHook Reçoit des messages ou des notifications destinés à la procédure de boîte de dialogue par défaut de la boîte de dialogue Mise en page . Il s’agit d’une fonction de rappel définie par l’application ou définie par la bibliothèque utilisée avec la fonctionPageSetupDlg.
PrintDlg Affiche uneboîte de dialogue Imprimer. La boîte de dialogue Imprimer permet à l’utilisateur de spécifier les propriétés d’un travail d’impression particulier.
PrintDlgEx Affiche une feuille de propriétés Print qui permet à l’utilisateur de spécifier les propriétés d’un travail d’impression particulier. Une feuille de propriétésImprimera une page Général qui contient des contrôles similaires à la boîte de dialogue Imprimer . La feuille de propriétés peut également contenir des pages de propriétés supplémentaires spécifiques à l’application et au pilote, ainsi que la page Général .
PrintHookProc Reçoit des messages ou des notifications destinés à la procédure de boîte de dialogue par défaut de la boîte de dialogue Imprimer . Il s’agit d’une fonction de rappel définie par l’application ou définie par la bibliothèque qui est utilisée avec la fonction PrintDlg .
ReplaceText Crée une boîte de dialogue sans mode définie par le système qui permet à l’utilisateur de spécifier une chaîne à rechercher et une chaîne de remplacement, ainsi que des options pour contrôler les opérations de recherche et de remplacement.
SetupHookProc Fonction de rappel définie par l’application ou définie par la bibliothèque utilisée avec la fonction PrintDlg . La procédure de raccordement reçoit des messages ou des notifications destinés à la procédure de boîte de dialogue par défaut de la boîte de dialogue Configuration de l’impression.

Interfaces

Nom Description
IPrintDialogCallback Fournit des méthodes qui permettent à une application de recevoir des notifications et des messages de la fonction PrintDlgEx lorsque la feuille de propriétés d’impression s’affiche.
IPrintDialogServices Fournit des méthodes qui permettent à une application utilisant la fonction PrintDlgEx de récupérer des informations sur l’imprimante actuellement sélectionnée.

Messages

Nom Description
CDM_GETFILEPATH Récupère le chemin d’accès et le nom du fichier sélectionné dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue.
CDM_GETFOLDERIDLIST Récupère l’adresse de la liste d’identificateurs d’élément correspondant au dossier qu’une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer a actuellement ouverte. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue.
CDM_GETFOLDERPATH Récupère le chemin du dossier ou répertoire actuellement ouvert pour une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue.
CDM_GETSPEC Récupère le nom de fichier (sans le chemin d’accès) du fichier actuellement sélectionné dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue.
CDM_HIDECONTROL Masque le contrôle spécifié dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue.
CDM_SETCONTROLTEXT Définit le texte du contrôle spécifié dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue.
CDM_SETDEFEXT Définit l’extension de nom de fichier par défaut pour une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue.
SETRGBSTRING La procédure de crochet d’une boîte de dialogue Couleur , CCHookProc, peut envoyer le message inscrit SETRGBSTRING à la boîte de dialogue pour définir la sélection de couleur actuelle.
WM_CHOOSEFONT_GETLOGFONT Une application envoie le message WM_CHOOSEFONT_GETLOGFONT à une boîte de dialogue Police pour récupérer des informations sur les sélections de polices actuelles de l’utilisateur.
WM_CHOOSEFONT_SETFLAGS Une application envoie le message WM_CHOOSEFONT_SETFLAGS à une boîte de dialogue Police pour définir les options d’affichage de la boîte de dialogue.
WM_CHOOSEFONT_SETLOGFONT Une application envoie le message WM_CHOOSEFONT_SETLOGFONT à une boîte de dialogue Police pour définir les informations de police logique actuelles.

Notifications

Nom Description
CDN_FILEOK Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer lorsque l’utilisateur spécifie un nom de fichier et clique sur le bouton OK.
CDN_FOLDERCHANGE Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer lors de l’ouverture d’un nouveau dossier.
CDN_HELP Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer lorsque l’utilisateur clique sur le bouton Aide.
CDN_INCLUDEITEM Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous pour déterminer si la boîte de dialogue doit afficher un élément dans la liste d’éléments d’un dossier d’interpréteur de commandes. Lorsque l’utilisateur ouvre un dossier, la boîte de dialogue envoie une notification CDN_INCLUDEITEM pour chaque élément du dossier. La boîte de dialogue envoie cette notification uniquement si l’indicateur OFN_ENABLEINCLUDENOTIFY a été défini lors de la création de la boîte de dialogue.
CDN_INITDONE Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer lorsque le système a terminé d’organiser les contrôles dans la boîte de dialogue. Le système déplace les contrôles standard pour faire de la place aux contrôles de la boîte de dialogue enfant.
CDN_SELCHANGE Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer lorsque la sélection change dans la zone de liste qui affiche le contenu du dossier ou répertoire actuellement ouvert.
CDN_SHAREVIOLATION Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer lorsque l’utilisateur clique sur le bouton OK et qu’une violation de partage réseau se produit pour le fichier sélectionné.
CDN_TYPECHANGE Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer lorsque l’utilisateur sélectionne un nouveau type de fichier dans la zone de liste déroulante Types de fichiers.
COLOROKSTRING Une boîte de dialogue Couleur envoie le message inscrit COLOROKSTRING à votre procédure de hook, CCHookProc, lorsque l’utilisateur sélectionne une couleur et clique sur le bouton OK . La procédure de crochet peut accepter la couleur et autoriser la boîte de dialogue à se fermer, ou rejeter la couleur et forcer la boîte de dialogue à rester ouverte.
FILEOKSTRING Une boîte de dialogue Ouvrir ou Enregistrer sous envoie le message enregistré FILEOKSTRING à votre procédure de hook, OFNHookProc, lorsque l’utilisateur spécifie un nom de fichier et clique sur le bouton OK . La procédure de crochet peut accepter le nom du fichier et autoriser la boîte de dialogue à se fermer, ou rejeter le nom du fichier et forcer la boîte de dialogue à rester ouverte.
FINDMSGSTRING Une boîte de dialogue Rechercher ou remplacer envoie le message inscrit FINDMSGSTRING à la procédure de fenêtre de sa fenêtre propriétaire lorsque l’utilisateur clique sur le bouton Rechercher suivant, Remplacer ou Remplacer tout , ou ferme la boîte de dialogue.
HELPMSGSTRING Une boîte de dialogue courante envoie le message inscrit HELPMSGSTRING à la procédure de fenêtre de sa fenêtre propriétaire lorsque l’utilisateur clique sur le bouton Aide .
LBSELCHSTRING Une boîte de dialogue Ouvrir ou Enregistrer sous envoie le message inscrit LBSELCHSTRING à votre procédure de crochet lorsque la sélection change dans l’une des zones de liste ou de liste déroulante de la boîte de dialogue.
SHAREVISTRING Une boîte de dialogue Ouvrir ou Enregistrer sous envoie le message inscrit SHAREVISTRING à votre procédure de hook, OFNHookProc, si une violation de partage se produit pour le fichier sélectionné lorsque l’utilisateur clique sur le bouton OK .
WM_PSD_ENVSTAMPRECT Avertit la procédure de crochet d’une boîte de dialogue Mise en page , PagePaintHook, que la boîte de dialogue est sur le point de dessiner le rectangle d’empreinte d’enveloppe de l’exemple de page.
WM_PSD_FULLPAGERECT Notifie une procédure de crochet PagePaintHook des coordonnées de l’exemple de rectangle de page dans la boîte de dialogue Mise en page. La boîte de dialogue envoie ce message lorsqu’elle est sur le point de dessiner le contenu de l’exemple de page.
WM_PSD_GREEKTEXTRECT Avertit la procédure de crochet d’une boîte de dialogue Mise en page , PagePaintHook, que la boîte de dialogue est sur le point de dessiner du texte grec à l’intérieur du rectangle de marge de l’exemple de page.
WM_PSD_MARGINRECT Avertit la procédure de crochet d’une boîte de dialogue Mise en page , PagePaintHook, que la boîte de dialogue est sur le point de dessiner le rectangle de marge de l’exemple de page.
WM_PSD_MINMARGINRECT Avertit une procédure de crochet PagePaintHook des coordonnées du rectangle de marge dans l’exemple de page. Une boîte de dialogue Mise en page envoie ce message lorsqu’il est sur le point de dessiner le contenu de l’exemple de page.
WM_PSD_PAGESETUPDLG Avertit une procédure de crochet PagePaintHook que la boîte de dialogue Mise en page est sur le point de dessiner le contenu de l’exemple de page. La procédure de hook peut utiliser ce message pour effectuer des tâches d’initialisation liées au dessin du contenu de l’exemple de page.
WM_PSD_YAFULLPAGERECT Avertit la procédure de crochet d’une boîte de dialogue Mise en page , PagePaintHook, que la boîte de dialogue est sur le point de dessiner la partie d’adresse de retour d’un exemple de page d’enveloppe.

Structures

Nom Description
CHOOSECOLOR Contient des informations que la fonction ChooseColor utilise pour initialiser la boîte de dialogue Couleur . Une fois que l’utilisateur ferme la boîte de dialogue, le système retourne des informations sur la sélection de l’utilisateur dans cette structure.
CHOOSEFONT Contient les informations que la fonction ChooseFont utilise pour initialiser la boîte de dialogue Police . Une fois que l’utilisateur ferme la boîte de dialogue, le système retourne des informations sur la sélection de l’utilisateur dans cette structure.
DEVNAMES Contient des chaînes qui identifient les noms de pilotes, de périphériques et de ports de sortie d’une imprimante. Les fonctions PrintDlgEx et PrintDlg utilisent ces chaînes pour initialiser la feuille de propriétés d’impression définie par le système ou la boîte de dialogue Imprimer. Lorsque l’utilisateur ferme la feuille de propriétés ou la boîte de dialogue, des informations sur l’imprimante sélectionnée sont retournées dans cette structure.
FINDREPLACE Contient des informations que les fonctions FindText et ReplaceText utilisent pour initialiser les boîtes de dialogue Rechercher et Remplacer . Le message inscrit FINDMSGSTRING utilise cette structure pour passer l’entrée de recherche ou de remplacement de l’utilisateur à la fenêtre propriétaire d’une boîte de dialogue Rechercher ou remplacer .
OFNOTIFY C contient des informations sur un message WM_NOTIFY envoyé à une procédure de crochet OFNHookProc pour une boîte de dialogue Ouvrir ou Enregistrer sous . Le paramètre lParam du message WM_NOTIFY est un pointeur vers une structure OFNOTIFY .
OFNOTIFYEX Contient des informations sur un message de notification CDN_INCLUDEITEM .
OPENFILENAME Contient des informations que les fonctions GetOpenFileName et GetSaveFileName utilisent pour initialiser une boîte de dialogue Ouvrir ou Enregistrer sous . Une fois que l’utilisateur ferme la boîte de dialogue, le système retourne des informations sur la sélection de l’utilisateur dans cette structure.
OPENFILENAME_NT4 Identique à OPENFILENAME avec _WIN32_WINNT défini sur 0x0400.
PAGESETUPDLG Contient des informations que la fonction PageSetupDlg utilise pour initialiser la boîte de dialogue Mise en page . Une fois que l’utilisateur ferme la boîte de dialogue, le système retourne des informations sur les paramètres de page définis par l’utilisateur dans cette structure.
PRINTDLG Contient les informations que la fonction PrintDlg utilise pour initialiser la boîte de dialogue Imprimer. Une fois la boîte de dialogue fermée par l’utilisateur, le système utilise cette structure pour retourner des informations sur les sélections de l’utilisateur.
PRINTDLGEX Contient les informations que la fonction PrintDlgEx utilise pour initialiser la feuille de propriétés Print. Une fois que l’utilisateur a fermé la feuille de propriétés, le système utilise cette structure pour retourner des informations sur les sélections de l’utilisateur.
PRINTPAGERANGE Spécifie une plage de pages dans un travail d’impression. Un travail d’impression peut avoir plusieurs plages de pages. Ces informations sont fournies dans la structure PRINTDLGEX lors de l’appel de la fonction PrintDlgEx .