int AfxMessageBox ( LPCTSTR lpszText, UINT nType = MB_OK, UINT nIDHelp = 0 );
int AFXAPI AfxMessageBox ( UINT nIDPrompt, UINT nType = MB_OK, UINT nIDHelp = (UINT) -1 );
Valeur de retour
Zéro s'il n'y a pas assez de mémoire pour afficher la boîte de message ; sinon, l'une des valeurs suivantes est retournée:
Si une boîte de message comporte un bouton Annuler, la valeur IDCANCEL sera retourné si la touche ÉCHAP ou le bouton Annuler est sélectionné. Si la boîte de message n'a pas de bouton Annuler, appuyer sur la touche ÉCHAP n'a aucun effet.
Les fonctions AfxFormatString1 et AfxFormatString2 peuvent être utiles à la mise en forme du texte qui apparaît dans une boîte de message.
Paramètres
lpszText
Pointe vers une chaîne terminée par null, contenant le message à afficher dans la boîte de message ou un objet CString.
nType
Le style de la boîte de message. Appliquer l'u&n des styles de la boîte de message pour le box.nbsp;
nIDHelp
L'ID de contexte d'aide pour le message ; 0 indique le contexte d'aide de l'application par défaut sera utilisé.
nIDPrompt
Un ID unique utilisé pour référencer une chaîne dans la table de chaînes.
Remarques
Affiche une boîte de message sur l'écran. La première forme de cette fonction surchargée affiche une chaîne de texte pointée par lpszText dans la boîte de message et utilise nIDHelp pour décrire un contexte d'aide. Le contexte de l'aide est utilisé pour accéder à une rubrique d'aide associée lorsque l'utilisateur appuie sur la touche d'aide (généralement F1).
La seconde forme de la fonction utilise la ressource de type chaîne avec l' ID nIDPrompt pour afficher un message dans la boîte de message. La page d'aide associée se trouve via la valeur de nIDHelp. Si la valeur par défaut nIDHelp est utilisée (– 1), l'ID de ressource de chaîne, nIDPrompt, est utilisé pour le contexte d'aide. Pour plus d'informations sur la définition des contextes d'aide, consultez l'article rubriques d'aide dans le Guide du programmeur Visual C++ et techniques &Note 28.nbsp;
Voir aussi ;CWnd::MessageBox