Bibliothèque de boîtes de dialogue communes
La bibliothèque de boîtes de dialogue communes contient un ensemble de boîtes de dialogue pour accomplir des tâches courantes d’application, telles que l’ouverture de fichiers, le choix de valeurs de couleur et l’impression de documents. Les boîtes de dialogue communes vous permettent de mettre en œuvre une approche cohérente avec les applications pour l’interface utilisateur de votre application. Cela réduit l’effort que les utilisateurs doivent fournir pour apprendre le comportement de l’interface utilisateur de votre application.
Cette section décrit les boîtes de dialogue communes qui incluent les boîtes de dialogue de fichiers Ouvrir et Enregistrer sous ; les boîtes de dialogue d’édition Rechercher et Remplacer ; les boîtes de dialogue d’impression Imprimer, Configuration de l’impression, Feuille de propriétés d’impression, et Configuration de page ; ainsi que les boîtes de dialogue Couleur et Police.
Remarque
À partir de Windows Vista, les boîtes de dialogue communes Ouvrir et Enregistrer sous ont été remplacées par la Boîte de dialogue commune d’éléments. Nous recommandons d’utiliser l’API de la boîte de dialogue commune d’éléments à la place 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 communes | Discute des différentes boîtes de dialogue. |
| Indicateurs d’initialisation des boîtes de dialogue communes | Discute de la manière dont 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 communes | Discute de la manière d’utiliser les boîtes de dialogue communes. |
| Utilisation des boîtes de dialogue courantes | Couvre les tâches qui invoquent des boîtes de dialogue communes. |
| Référence des boîtes de dialogue communes | Contient la référence API. |
Functions
| 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 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 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 des attributs pour une police logique. Ces attributs incluent une famille de polices et un style de police associé, une taille en points, des effets (soulignement, barré et couleur du texte), ainsi qu’un script (ou jeu de caractères). |
| CommDlgExtendedError | Renvoie un code d’erreur de boîte de dialogue commune. Ce code indique la dernière erreur survenue lors de l’exécution de l’une des fonctions de la boîte de dialogue commune. |
| FindText | Crée une boîte de dialogue non modale définie par le système Rechercher qui permet à l’utilisateur de spécifier une chaîne à rechercher et des 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 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 des messages de notification envoyés par la boîte de dialogue. La fonction reçoit également des messages pour tout contrôle supplémentaire que vous avez défini 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 la bibliothèque qui est utilisée avec les boîtes de dialogue Ouvrir et Enregistrer sous de style Explorateur. |
| 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 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 la page d’exemple dans la boîte de dialogue Configuration de page. Il s’agit d’une fonction de rappel définie par l’application ou la bibliothèque utilisée avec la fonction PageSetupDlg. |
| PageSetupDlg | Crée une boîte de dialogue Configuration de page qui permet à l’utilisateur de spécifier les attributs d’une page imprimée. Ces attributs incluent la taille et la source du papier, l’orientation de la page (portrait ou paysage), et la largeur des marges de la 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 Configuration de page. Il s’agit d’une fonction de rappel définie par l’application ou la bibliothèque utilisée avec la fonction PageSetupDlg. |
| PrintDlg | Affiche une boîte de dialogue d’impression. 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 Imprimer qui permet à l’utilisateur de spécifier les propriétés d’un travail d’impression particulier. Une feuille de propriétés Imprimer contient une page Général qui comprend des contrôles similaires à ceux de 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 la bibliothèque qui est utilisée avec la fonction PrintDlg. |
| ReplaceText | Crée une boîte de dialogue non modale 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 | Une fonction de rappel définie par l’application ou la bibliothèque utilisée avec la fonction PrintDlg. La procédure de rappel 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 permettant à une application de recevoir des notifications et des messages de la fonction PrintDlgEx pendant que la feuille de propriétés d’impression est affichée. |
| IPrintDialogServices | Fournit des méthodes permettant à 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 et le nom de fichier du fichier sélectionné dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorateur. 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 des identifiants d’éléments correspondant au dossier actuellement ouvert dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorateur. 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 Explorateur. 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 du fichier (sans inclure le chemin) du fichier actuellement sélectionné dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorateur. 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 Explorateur. 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 pour le contrôle spécifié dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorateur. 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 fichier par défaut pour une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorateur. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue. |
| SETRGBSTRING | La procédure de rappel d’une boîte de dialogue Couleur, CCHookProc, peut envoyer le message enregistré 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 police 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 actuelles de la police logique. |
Notifications
| Nom | Description |
|---|---|
| CDN_FILEOK | Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorateur 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 Explorateur lorsqu’un nouveau dossier est ouvert. |
| CDN_HELP | Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorateur 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 des éléments d’un dossier du shell. 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 Explorateur lorsque le système a terminé d’arranger 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 Explorateur lorsque la sélection change dans la zone de liste qui affiche le contenu du dossier ou du répertoire actuellement ouvert. |
| CDN_SHAREVIOLATION | Envoyé par une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorateur 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 Explorateur lorsque l’utilisateur sélectionne un nouveau type de fichier dans la zone de liste déroulante des types de fichiers. |
| COLOROKSTRING | Une boîte de dialogue Couleur envoie le message enregistré COLOROKSTRING à votre procédure de rappel, CCHookProc, lorsque l’utilisateur sélectionne une couleur et clique sur le bouton OK. La procédure de rappel peut accepter la couleur et permettre à la boîte de dialogue de 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 rappel, OFNHookProc, lorsque l’utilisateur spécifie un nom de fichier et clique sur le bouton OK. La procédure de rappel peut accepter le nom du fichier et permettre à la boîte de dialogue de 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 enregistré 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 commune envoie le message enregistré 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 enregistré LBSELCHSTRING à votre procédure de rappel lorsque la sélection change dans l’une des zones de liste ou zones de liste déroulante de la boîte de dialogue. |
| SHAREVISTRING | Une boîte de dialogue Ouvrir ou Enregistrer sous envoie le message enregistré SHAREVISTRING à votre procédure de rappel, OFNHookProc, si une violation de partage se produit pour le fichier sélectionné lorsque l’utilisateur clique sur le bouton OK. |
| WM_PSD_ENVSTAMPRECT | Notifie la procédure de rappel d’une boîte de dialogue Configuration de page, PagePaintHook, que la boîte de dialogue est sur le point de dessiner le rectangle du timbre de l’enveloppe de la page d’exemple. |
| WM_PSD_FULLPAGERECT | Notifie à une procédure de rappel PagePaintHook les coordonnées du rectangle de la page d’exemple dans la boîte de dialogue Configuration de page. La boîte de dialogue envoie ce message lorsqu’elle est sur le point de dessiner le contenu de la page d’exemple. |
| WM_PSD_GREEKTEXTRECT | Notifie la procédure de rappel d’une boîte de dialogue Configuration de page, PagePaintHook, que la boîte de dialogue est sur le point de dessiner un texte grec à l’intérieur du rectangle des marges de la page d’exemple. |
| WM_PSD_MARGINRECT | Notifie la procédure de rappel d’une boîte de dialogue Configuration de page, PagePaintHook, que la boîte de dialogue est sur le point de dessiner le rectangle des marges de la page d’exemple. |
| WM_PSD_MINMARGINRECT | Notifie à une procédure de rappel PagePaintHook les coordonnées du rectangle des marges dans la page d’exemple. Une boîte de dialogue Configuration de page envoie ce message lorsqu’elle est sur le point de dessiner le contenu de la page d’exemple. |
| WM_PSD_PAGESETUPDLG | Notifie à une procédure de rappel PagePaintHook que la boîte de dialogue Configuration de page est sur le point de dessiner le contenu de la page d’exemple. La procédure de rappel peut utiliser ce message pour effectuer des tâches d’initialisation liées au dessin du contenu de la page d’exemple. |
| WM_PSD_YAFULLPAGERECT | Notifie la procédure de rappel d’une boîte de dialogue Configuration de page, PagePaintHook, que la boîte de dialogue est sur le point de dessiner la partie de l’adresse de retour d’une page d’exemple d’enveloppe. |
Structures
| Nom | Description |
|---|---|
| CHOOSECOLOR | Contient des informations que la fonction ChooseColor utilise pour initialiser la boîte de dialogue Couleur. Après que l’utilisateur a fermé la boîte de dialogue, le système renvoie des informations sur la sélection de l’utilisateur dans cette structure. |
| CHOOSEFONT | Contient des informations que la fonction ChooseFont utilise pour initialiser la boîte de dialogue Police. Après que l’utilisateur a fermé la boîte de dialogue, le système renvoie des informations sur la sélection de l’utilisateur dans cette structure. |
| DEVNAMES | Contient des chaînes qui identifient le pilote, le périphérique et les noms de port de sortie d’une imprimante. Les fonctions PrintDlgEx et PrintDlg utilisent ces chaînes pour initialiser la Feuille de propriétés d’impression ou la Boîte de dialogue d’impression définie par le système. 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 renvoyé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 enregistré FINDMSGSTRING utilise cette structure pour transmettre les saisies de recherche ou de remplacement de l’utilisateur à la fenêtre propriétaire d’une boîte de dialogue Rechercher ou Remplacer. |
| OFNOTIFY | Contient des informations sur un message WM_NOTIFY envoyé à une procédure de rappel 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. Après que l’utilisateur a fermé la boîte de dialogue, le système renvoie des informations sur la sélection de l’utilisateur dans cette structure. |
| OPENFILENAME_NT4 | Identique à OPENFILENAME avec _WIN32_WINNT défini à 0x0400. |
| PAGESETUPDLG | Contient des informations que la fonction PageSetupDlg utilise pour initialiser la boîte de dialogue Configuration de page. Après que l’utilisateur a fermé la boîte de dialogue, le système renvoie des informations sur les paramètres de page définis par l’utilisateur dans cette structure. |
| PRINTDLG | Contient des informations que la fonction PrintDlg utilise pour initialiser la boîte de dialogue Imprimer. Après que l’utilisateur a fermé la boîte de dialogue, le système utilise cette structure pour renvoyer des informations sur les sélections de l’utilisateur. |
| PRINTDLGEX | Contient des informations que la fonction PrintDlgEx utilise pour initialiser la feuille de propriétés d’impression. Après que l’utilisateur a fermé la feuille de propriétés, le système utilise cette structure pour renvoyer 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 plus d’une plage de pages. Ces informations sont fournies dans la structure PRINTDLGEX lors de l’appel de la fonction PrintDlgEx. |