Partager via


AfxMessageBox

Affiche un message sur l'écran.

int AfxMessageBox(
   LPCTSTR lpszText,
   UINT nType = MB_OK,
   UINT nIDHelp = 0 
);
int AFXAPI AfxMessageBox(
   UINT nIDPrompt,
   UINT nType = MB_OK,
   UINT nIDHelp = (UINT
) -1 
);

Paramètres

  • lpszText
    Pointe vers un objet ou une chaîne terminée par le caractère NULL d' CString contenant le message à afficher dans le message.

  • nType
    Le style du message.Appliquez styles de boîte de message l'un des à la zone.

  • nIDHelp
    l'ID de contexte d'aide pour le message ; 0 indique l'aide de la valeur par défaut de l'application que le contexte sera utilisé.

  • nIDPrompt
    Identificateur unique utilisé pour référencer une chaîne dans la table de chaînes.

Valeur de retour

Zéro s'il n'y a pas assez de mémoire pour afficher le message ; sinon, l'une des valeurs suivantes est retournée :

  • IDABORT le bouton d'arrêt a été sélectionné.

  • IDCANCEL le bouton Annuler a été sélectionné.

  • IDIGNORE le bouton d'ignorer a été sélectionné.

  • IDNO un bouton a été sélectionné.

  • IDOK le bouton OK a été sélectionné.

  • IDRETRY le bouton de démarrage a été sélectionné.

  • IDYES le bouton d'oui a été sélectionné.

Si un message comporte un bouton Annuler, la valeur d' IDCANCEL est retournée si ou la touche Échap est enfoncée ou Annuler est sélectionné.Si le message n'a aucun bouton Annuler, en appuyant sur la touche Échap n'a aucun effet.

Les fonctions AfxFormatString1 et AfxFormatString2 peuvent être utiles dans le texte de mise en forme qui s'affiche dans un message.

Notes

Le premier formulaire de cette fonction surchargée affiche une chaîne de texte désignée par lpszText dans le message et utilise nIDHelp pour décrire un contexte d'aide.Le contexte d'aide est utilisé pour accéder à une rubrique d'aide associée lorsque l'utilisateur appuie sur la touche Help (en général F1).

Le deuxième formulaire de la fonction utilise la ressource de type chaîne avec l'ID nIDPrompt pour afficher un message dans le message.La page d'aide associée est recherchée jusqu'à la valeur d' nIDHelp.Si la valeur par défaut d' nIDHelp est utilisée (– 1), l'ID de ressource de type chaîne, nIDPrompt, est utilisé pour le contexte d'aide.Pour plus d'informations sur la définition des contextes d'aide, consultez note technique 28.

Exemple

// A simple message box, with only the OK button.
AfxMessageBox(_T("Simple message box."));

// A message box that uses a string from a string table
// with yes and no buttons and the stop icon.
// NOTE: nStringID is an integer that contains a valid id of
// a string in the current resource.
AfxMessageBox(nStringID, MB_YESNO|MB_ICONSTOP);

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CWnd::MessageBox

Concepts

Macro MFC et Globals