Partager via


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

Une boîte de dialogue est une fenêtre temporaire créée par une application pour récupérer les entrées utilisateur. Une application utilise généralement des boîtes de dialogue pour inviter l’utilisateur à fournir des informations supplémentaires sur 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 Traite de l’utilisation des boîtes de dialogue dans l’interface utilisateur de vos applications.
Considérations relatives à la programmation des boîtes de dialogue Cette vue d’ensemble présente certaines considérations relatives à la programmation concernant les boîtes de dialogue.
Utilisation de boîtes de dialogue Vous utilisez des boîtes de dialogue pour afficher des informations et demander une entrée de l’utilisateur.
Informations de référence sur la boîte de dialogue Informations de référence sur l’API
Bibliothèque de boîtes de dialogue commune Traite de 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 des 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 des 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 un traitement par défaut pour tous les 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 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 .
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 met fin à 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 des 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 des contrôles de boîte de dialogue.
DialogProc Fonction de rappel définie par l’application utilisée avec les familles de fonctions CreateDialog et DialogBox . 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 fonction défini par l’application.
EndDialog Détruit une boîte de dialogue modale, ce qui entraîne la fin du traitement de la boîte de dialogue par le système.
GetDialogBaseUnits Récupère les unités de base de boîte de dialogue du système, qui sont la largeur et la hauteur moyennes 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 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 d’unités de modèle 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 de boîte de dialogue.
GetNextDlgGroupItem Récupère un handle pour le premier contrôle d’un groupe de contrôles qui précède (ou suit) le contrôle spécifié dans une boîte de dialogue.
GetNextDlgTabItem Récupère un handle au 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 de la structure RECT spécifiée par les coordonnées converties, ce qui permet d’utiliser la structure 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 des informations de status ou d’erreur. La boîte de message retourne une valeur entière qui indique le bouton sur lequel l’utilisateur a cliqué.
MessageBoxEx Crée, affiche et utilise 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 utilise une boîte de message. La zone de message contient le texte et le titre du message défini par l’application, n’importe quelle icône et toute combinaison de boutons d’envoi 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 pousseur par défaut pour une boîte de dialogue.
DM_REPOSITION Repositionne une boîte de dialogue de niveau supérieur afin qu’elle s’intègre dans la zone du bureau. Une application peut envoyer ce message à une boîte de dialogue après le redimensionnement pour s’assurer que l’intégralité de la boîte de dialogue reste visible.
DM_SETDEFID Modifie l’identificateur du bouton pousseur 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 son texte et ses couleurs d’arrière-plan à l’aide du handle de contexte de périphérique d’affichage spécifié.
WM_ENTERIDLE Envoyé à la fenêtre propriétaire d’une boîte de dialogue modale ou d’un menu qui entre dans un état inactif. Une boîte de dialogue ou un menu modal passe à l’état inactif lorsqu’aucun message n’attend dans sa file d’attente après avoir 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 clavier dans le contrôle ; le système interprète certains types d’entrée au clavier comme des 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 des 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 à 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 d’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, par conséquent, le nombre de structures 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 les informations utilisées pour afficher une boîte de message. La fonction MessageBoxIndirect utilise cette structure.