AfxMessageBox
Affiche une boîte de 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 CString ou une chaîne terminée par le caractère NULL contenant le message à afficher dans la boîte de message.nType
Style de la boîte de message. Applique un style de boîte de message w0kywcw3(v=vs.120).md à la boîte.nIDHelp
ID de contexte d'aide du message ; 0 indique que le contexte d'aide par défaut de l'application 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 Abandonner a été sélectionné.
IDCANCEL Le bouton Annuler a été sélectionné.
IDIGNORE Le bouton Ignorer a été sélectionné.
IDNO Le bouton Non a été sélectionné.
IDOK Le bouton OK a été sélectionné.
IDRETRY Le bouton Réessayer a été sélectionné.
IDYES Le bouton Oui a été sélectionné.
Si une boîte de message comporte un bouton Annuler, la valeur IDCANCEL est retournée si la touche Échap est utilisée ou que le bouton Annuler est sélectionné. Si la boîte de message n'a pas de bouton Annuler, le fait d'appuyer sur la touche Échap n'a aucun effet.
Les fonctions AfxFormatString1 and AfxFormatString2 peuvent être utiles pour mettre en forme le texte qui s'affiche dans un message.
Notes
La première forme de cette fonction surchargée affiche une chaîne de texte vers laquelle pointe lpszText dans la boîte de 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 d'aide (généralement F1).
Le deuxième formulaire de la fonction utilise la ressource de type chaîne ayant l'ID nIDPrompt pour afficher un message dans la boîte de message. La page d'aide associée est trouvée à l'aide de la valeur de nIDHelp. Si la valeur par défaut de 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
En-tête : afxwin.h