Fonction MessageBoxExA (winuser.h)

Article
08/27/2023

Crée, affiche et gère 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.

Actuellement , MessageBoxEx et MessageBox fonctionnent de la même façon.

Syntaxe

int MessageBoxExA(
  [in, optional] HWND   hWnd,
  [in, optional] LPCSTR lpText,
  [in, optional] LPCSTR lpCaption,
  [in]           UINT   uType,
  [in]           WORD   wLanguageId
);

Paramètres

[in, optional] hWnd

Type : HWND

Handle de la fenêtre propriétaire de la boîte de message à créer. Si ce paramètre a la valeur NULL, la zone de message n’a pas de fenêtre propriétaire.

[in, optional] lpText

Type : LPCTSTR

Message à afficher.

[in, optional] lpCaption

Type : LPCTSTR

Titre de la boîte de dialogue. Si ce paramètre a la valeur NULL, le titre par défaut Erreur est utilisé.

[in] uType

Type : UINT

Contenu et comportement de la boîte de dialogue. Pour plus d’informations sur les indicateurs pris en charge, consultez MessageBox.

[in] wLanguageId

Type : WORD

Langue du texte affiché dans le ou les boutons de la zone de message. La spécification d’une valeur de zéro (0) indique l’affichage du texte du bouton dans la langue système par défaut. Si ce paramètre est MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL), la langue actuelle associée au thread appelant est utilisée.

Pour spécifier une langue autre que la langue actuelle, utilisez la macro MAKELANGID pour créer ce paramètre. Pour plus d’informations, consultez MAKELANGID.

Valeur retournée

Type : int

Si une zone de message comporte un bouton Annuler , la fonction retourne la valeur IDCANCEL si vous appuyez sur la touche Échap ou si le bouton Annuler est sélectionné. Si la boîte de message n’a pas de bouton Annuler , appuyer sur Échap n’aura aucun effet, sauf si un bouton MB_OK est présent. Si un bouton MB_OK s’affiche et que l’utilisateur appuie sur Échap, la valeur de retour est IDOK.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Si la fonction réussit, la valeur de retour est l’une des valeurs d’élément de menu suivantes.

Code/valeur de retour	Description
IDABORT 3	Le bouton Abandonner a été sélectionné.
IDCANCEL 2	Le bouton Annuler a été sélectionné.
IDCONTINUE 11	Le bouton Continuer a été sélectionné.
IDIGNORE 5	Le bouton Ignorer a été sélectionné.
IDNO 7	Le bouton Non a été sélectionné.
IDOK 1	Le bouton OK a été sélectionné.
IDRETRY 4	Le bouton Réessayer a été sélectionné.
IDTRYAGAIN 10	Le bouton Réessayer a été sélectionné.
IDYES 6	Le bouton Oui a été sélectionné.

Remarques

Lorsque vous utilisez une boîte de message modale système pour indiquer que le système est faible en mémoire, les chaînes pointées par les paramètres lpText et lpCaption ne doivent pas être extraites d’un fichier de ressources, car une tentative de chargement de la ressource peut échouer.

Si vous créez une boîte de message alors qu’une boîte de dialogue est présente, utilisez un handle de la boîte de dialogue comme paramètre hWnd . Le paramètre hWnd ne doit pas identifier une fenêtre enfant, telle qu’un contrôle dans une boîte de dialogue.

Notes

L’en-tête winuser.h définit MessageBoxEx comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll