Fonction MessageBoxExA (winuser.h)

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 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 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.

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.

Exigences

Voir aussi

conceptuelle

boîtes de dialogue

MAKELANGID

messageBeep

messageBox

MessageBoxIndirect

autres ressources

de référence

SetForegroundWindow