MessageBoxExW, fonction (winuser.h)

Article
11/20/2024

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.

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

Syntaxe

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

Paramètres

[in, optional] hWnd

Type : HWND

Handle vers la fenêtre propriétaire de la boîte de message à créer. Si ce paramètre est 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 est 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 boîte de message. La spécification d’une valeur égale à zéro (0) indique d’afficher le 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 de retour

Type : int

Si une boîte de message a un bouton Annuler, la fonction renvoie la valeur IDCANCEL si la touche ÉCHAP est enfoncée ou si le bouton Annuler est sélectionné. Si la boîte de message n’a aucun bouton Annuler, l’appui sur Échap n’a aucun effet, sauf si un bouton MB_OK est présent. Si un bouton MB_OK est affiché 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’erreur étendues, appelez GetLastError.

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

Retourner le code/la valeur	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 Aucun 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 l'lpText et paramètres lpCaption ne doivent pas être extraits d’un fichier de ressources, car une tentative de chargement de la ressource peut échouer.

Si vous créez une boîte de message pendant qu’une boîte de dialogue est présente, utilisez un handle pour la boîte de dialogue en tant que 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.

Note

L’en-tête winuser.h définit MessageBoxEx comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll