Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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. |