CWnd::MessageBox

 

Crée et affiche une fenêtre qui contient un message et une légende fournis par l'application, suivi d'une combinaison des icônes et des boutons poussoir prédéfinis décrits dans la liste de styles de boîte de message .

Syntaxe

      int MessageBox(
   LPCTSTR lpszText,
   LPCTSTR lpszCaption = NULL,
   UINT nType = MB_OK 
);

Paramètres

• lpszText
  Les points à CString objet ou chaîne terminée par le caractère NULL contenant le message à afficher.

• lpszCaption
  Les points à CString objet ou chaîne terminée par le caractère NULL à utiliser pour la légende de message.  Si lpszCaption est NULL, la légende par défaut « erreur » est utilisée.  

• nType
  Spécifie le contenu et le comportement du message.

Valeur de retour

Cette méthode utilise la fonction de MessageBox définie dans SDK Windows.  Cette méthode retourne le résultat de l'appel de cette fonction.  

Notes

Utilisez la fonction globale AfxMessageBox au lieu de cette fonction membre pour implémenter un message dans votre application.

Voici les différents icones système qui peuvent être utilisés dans un message :

	MB_ICONHAND, MB_ICONSTOP, et MB_ICONERROR
	MB_ICONQUESTION
	MB_ICONEXCLAMATION et MB_ICONWARNING
	MB_ICONASTERISK et MB_ICONINFORMATION

Exemple

void CMainFrame::OnDisplayErrorMessage()
{
   // This displays a message box with the title "Error"
   // and the message "Help, Something went wrong."
   // The error icon is displayed in the message box, along with
   // an OK button.
   MessageBox(_T("Help, Something went wrong."), _T("Error"), 
      MB_ICONERROR | MB_OK);
}

Configuration requise

Header: afxwin.h

Voir aussi

CWnd, classe
Graphique hiérarchique
MessageBox
AfxMessageBox