Boîtes de dialogue (boîtes de dialogue)

Une boîte de dialogue est une fenêtre temporaire qu’une application crée pour récupérer l’entrée utilisateur. Une application utilise généralement des boîtes de dialogue pour inviter l’utilisateur à obtenir des informations supplémentaires pour les éléments de menu. Une boîte de dialogue contient généralement un ou plusieurs contrôles (fenêtres enfants) avec lesquels l’utilisateur entre du texte, choisit des options ou dirige l’action.

Windows fournit également des boîtes de dialogue prédéfinies qui prennent en charge les éléments de menu courants tels que Ouvrir et Imprimer. Les applications qui utilisent ces éléments de menu doivent utiliser les boîtes de dialogue courantes pour demander cette entrée utilisateur, quel que soit le type d’application.

Dans cette section

Nom	Description
À propos des boîtes de dialogue	Décrit l’utilisation de boîtes de dialogue dans l’interface utilisateur de vos applications.
Considérations relatives à la programmation de boîte de dialogue	Cette vue d’ensemble présente certaines considérations relatives à la programmation concernant les boîtes de dialogue.
à l’aide de boîtes de dialogue	Vous utilisez des boîtes de dialogue pour afficher des informations et demander l’entrée de l’utilisateur.
boîte de dialogue Référence	Informations de référence sur l’API
bibliothèque de boîtes de dialogue courante	Décrit l’utilisation des boîtes de dialogue courantes dans l’interface utilisateur de vos applications.

Fonctions de boîte de dialogue

Nom	Description
createDialog	Crée une boîte de dialogue sans mode à partir d’une ressource de modèle de boîte de dialogue.
CreateDialogIndirect	Crée une boîte de dialogue sans mode à partir d’un modèle de boîte de dialogue en mémoire.
CreateDialogIndirectParam	Crée une boîte de dialogue sans mode à partir d’un modèle de boîte de dialogue en mémoire. Avant d’afficher la boîte de dialogue, la fonction transmet une valeur définie par l’application à la procédure de boîte de dialogue en tant que paramètre lParam du message WM_INITDIALOG. Une application peut utiliser cette valeur pour initialiser les contrôles de boîte de dialogue.
CreateDialogParam	Crée une boîte de dialogue sans mode à partir d’une ressource de modèle de boîte de dialogue. Avant d’afficher la boîte de dialogue, la fonction transmet une valeur définie par l’application à la procédure de boîte de dialogue en tant que paramètre lParam du message WM_INITDIALOG. Une application peut utiliser cette valeur pour initialiser les contrôles de boîte de dialogue.
DefDlgProc	Appelle la procédure de fenêtre de boîte de dialogue par défaut pour fournir le traitement par défaut des messages de fenêtre qu’une boîte de dialogue avec une classe de fenêtre privée ne traite pas.
DialogBox	Crée une boîte de dialogue modale à partir d’une ressource de modèle de boîte de dialogue. dialogBox ne retourne pas de contrôle tant que la fonction de rappel spécifiée n’arrête pas la boîte de dialogue modale en appelant la fonction EndDialog.
DialogBoxIndirect	Crée une boîte de dialogue modale à partir d’un modèle de boîte de dialogue en mémoire. DialogBoxIndirect ne retourne pas le contrôle tant que la fonction de rappel spécifiée n’arrête pas la boîte de dialogue modale en appelant la fonction EndDialog.
DialogBoxIndirectParam	Crée une boîte de dialogue modale à partir d’un modèle de boîte de dialogue en mémoire. Avant d’afficher la boîte de dialogue, la fonction transmet une valeur définie par l’application à la procédure de boîte de dialogue en tant que paramètre lParam du message WM_INITDIALOG. Une application peut utiliser cette valeur pour initialiser les contrôles de boîte de dialogue.
dialogBoxParam	Crée une boîte de dialogue modale à partir d’une ressource de modèle de boîte de dialogue. Avant d’afficher la boîte de dialogue, la fonction transmet une valeur définie par l’application à la procédure de boîte de dialogue en tant que paramètre lParam du message WM_INITDIALOG. Une application peut utiliser cette valeur pour initialiser les contrôles de boîte de dialogue.
dialogProc	Fonction de rappel définie par l’application utilisée avec la CreateDialog et DialogBox familles de fonctions. Il traite les messages envoyés à une boîte de dialogue modale ou sans mode. Le type DLGPROC définit un pointeur vers cette fonction de rappel. DialogProc est un espace réservé pour le nom de la fonction définie par l’application.
EndDialog	Détruit une boîte de dialogue modale, ce qui entraîne la fin du traitement du système pour la boîte de dialogue.
GetDialogBaseUnits	Récupère les unités de base de boîte de dialogue du système, qui sont la largeur moyenne et la hauteur des caractères dans la police système. Pour les boîtes de dialogue qui utilisent la police système, vous pouvez utiliser ces valeurs pour convertir entre les unités de modèle de boîte de dialogue, comme spécifié dans les modèles de boîte de dialogue et les pixels. Pour les boîtes de dialogue qui n’utilisent pas la police système, la conversion des unités de modèle de boîte de dialogue en pixels dépend de la police utilisée par la boîte de dialogue.
GetDlgCtrlID	Récupère l’identificateur du contrôle spécifié.
GetDlgItem	Récupère un handle dans un contrôle dans la boîte de dialogue spécifiée.
GetDlgItemInt	Convertit le texte d’un contrôle spécifié dans une boîte de dialogue en valeur entière.
GetDlgItemText	Récupère le titre ou le texte associé à un contrôle dans une boîte de dialogue.
GetNextDlgGroupItem	Récupère un handle dans le premier contrôle d’un groupe de contrôles qui précèdent (ou suivent) le contrôle spécifié dans une boîte de dialogue.
GetNextDlgTabItem	Récupère un handle dans le premier contrôle qui a le style WS_TABSTOP qui précède (ou suit) le contrôle spécifié.
IsDialogMessage	Détermine si un message est destiné à la boîte de dialogue spécifiée et, le cas échéant, traite le message.
MapDialogRect	Convertit les unités de boîte de dialogue spécifiées en unités d’écran (pixels). La fonction remplace les coordonnées dans le RECT structure spécifié par les coordonnées converties, ce qui permet à la structure d’être utilisée pour créer une boîte de dialogue ou positionner un contrôle dans une boîte de dialogue.
messageBox	Affiche une boîte de dialogue modale qui contient une icône système, un ensemble de boutons et un bref message spécifique à l’application, tel que les informations d’état ou d’erreur. La zone de message retourne une valeur entière qui indique le bouton sur lequel l’utilisateur a cliqué.
MessageBoxEx	Crée, affiche et exploite une boîte de message. La zone de message contient un message et un titre définis par l’application, ainsi que toute combinaison d’icônes prédéfinies et de boutons push. Les boutons sont dans la langue de l’interface utilisateur système.
MessageBoxIndirect	Crée, affiche et exploite une boîte de message. La zone de message contient le texte et le titre du message définis par l’application, toute icône et toute combinaison de boutons Push prédéfinis.
sendDlgItemMessage	Envoie un message au contrôle spécifié dans une boîte de dialogue.
SetDlgItemInt	Définit le texte d’un contrôle dans une boîte de dialogue sur la représentation sous forme de chaîne d’une valeur entière spécifiée.
SetDlgItemText	Définit le titre ou le texte d’un contrôle dans une boîte de dialogue.

Messages de boîte de dialogue

Nom	Description
DM_GETDEFID	Récupère l’identificateur du contrôle de bouton Push par défaut d’une boîte de dialogue.
DM_REPOSITION	Repositionne une boîte de dialogue de niveau supérieur afin qu’elle corresponde à la zone de bureau. Une application peut envoyer ce message à une boîte de dialogue après le redimensionnement pour vous assurer que la boîte de dialogue entière reste visible.
DM_SETDEFID	Modifie l’identificateur du bouton Push par défaut d’une boîte de dialogue.

Notifications de boîte de dialogue

Nom	Description
WM_CTLCOLORDLG	Envoyé à une boîte de dialogue avant que le système dessine la boîte de dialogue. En répondant à ce message, la boîte de dialogue peut définir ses couleurs de texte et d’arrière-plan à l’aide du handle de contexte d’appareil d’affichage spécifié.
WM_ENTERIDLE	Envoyé à la fenêtre propriétaire d’une boîte de dialogue modale ou d’un menu entrant un état inactif. Une boîte de dialogue modale ou un menu entre dans un état inactif lorsqu’aucun message n’attend dans sa file d’attente une fois qu’il a traité un ou plusieurs messages précédents.
WM_GETDLGCODE	Envoyé à la procédure de fenêtre associée à un contrôle. Par défaut, le système gère toutes les entrées du clavier dans le contrôle ; le système interprète certains types d’entrée de clavier en tant que touches de navigation de boîte de dialogue. Pour remplacer ce comportement par défaut, le contrôle peut répondre au message WM_GETDLGCODE pour indiquer les types d’entrée qu’il souhaite traiter lui-même.
WM_INITDIALOG	Envoyé à la procédure de boîte de dialogue immédiatement avant l’affichage d’une boîte de dialogue. Les procédures de boîte de dialogue utilisent généralement ce message pour initialiser les contrôles et effectuer d’autres tâches d’initialisation qui affectent l’apparence de la boîte de dialogue.
WM_NEXTDLGCTL	Envoyé à une procédure de boîte de dialogue pour définir le focus clavier sur un autre contrôle dans la boîte de dialogue.

Structures de boîte de dialogue

Nom	Description
DLGITEMTEMPLATE	Définit les dimensions et le style d’un contrôle dans une boîte de dialogue. Une ou plusieurs de ces structures sont combinées avec une structure DLGTEMPLATE pour former un modèle standard pour une boîte de dialogue.
DLGITEMTEMPLATEEX	Décrit une boîte de dialogue étendue. Pour obtenir une description du format d’un modèle de boîte de dialogue étendue, consultez DLGTEMPLATEEX.
DLGTEMPLATE	Définit les dimensions et le style d’une boîte de dialogue. Cette structure, toujours la première dans un modèle standard pour une boîte de dialogue, spécifie également le nombre de contrôles dans la boîte de dialogue et spécifie donc le nombre de structures d'DLGITEMTEMPLATE suivantes dans le modèle.
DLGTEMPLATEEX	Un modèle de boîte de dialogue étendu commence par un en-tête DLGTEMPLATEEX qui décrit la boîte de dialogue et spécifie le nombre de contrôles dans la boîte de dialogue. Pour chaque contrôle d’une boîte de dialogue, un modèle de boîte de dialogue étendu a un bloc de données qui utilise le format DLGITEMTEMPLATEEX pour décrire le contrôle.
MSGBOXPARAMS	Contient des informations utilisées pour afficher une boîte de message. La fonctionMessageBoxIndirectutilise cette structure.