intAfxMessageBox (LPCTSTRLpszText,UINTnTypeMB_OK,UINTnIDHelp=0=);
intAFXAPIAfxMessageBox (UINTnIDPrompt,UINTnTypeMB_OK,UINTnIDHelp=(UINT)-1=);
Rückgabewert
NULL, wenn es nicht genügend Arbeitsspeicher ist, um das Meldungsfeld anzeigen; Andernfalls wird einer der folgenden Werte zurückgegeben:
Wenn ein Meldungsfeld eine Schaltfläche Abbrechen verfügt, wird der Wert IDCANCEL werden zurückgegeben, wenn entweder die ESC-Taste gedrückt wird oder die Cancel-Taste ist gewählt. Wenn das Meldungsfeld keine Schaltfläche Abbrechen verfügt, hat drücken die ESC-Taste keine Wirkung.
Die Funktionen AfxFormatString1 und AfxFormatString2 können nützlich sein bei der Formatierung von Text, der in einem Meldungsfeld angezeigt wird.
Parameter
lpszText
Verweist auf ein CString -Objekt oder Null-terminierte Zeichenfolge mit der Meldung im Meldungsfeld angezeigt werden.
nType
De&n Stil des Meldungsfelds. Gelten Sie einen der Meldungsfeld Stile für die box.nbsp;
nIDHelp
Die Hilfekontext ID für die Nachricht; 0 gibt an, dass die Anwendung Standard-Hilfe-Kontext verwendet wird.
nIDPrompt
Eine eindeutige ID verwendet, um eine Zeichenfolge in der Zeichenfolgentabelle verwiesen.
Bemerkungen
Zeigt ein Meldungsfeld auf dem Bildschirm. Die erste Form dieser überladene Funktion zeigt einen Text-String, auf den LpszText im Meldungsfeld und nIDHelp verwendet, um einen Hilfekontext beschreiben. Der Hilfekontext wird verwendet, um ein Hilfethema springen soll, wenn der Benutzer die Hilfetaste (in der Regel F1 drückt).
Die zweite Form der Fu&nktion verwendet die String-Ressource mit der ID nIDPrompt eine Meldung in das Meldungsfeld anzuzeigen. Die zugehörige Hilfeseite wird durch den Wert des nIDHelpgefunden. Wenn der Standardwert von nIDHelp verwendet wird (– 1), die Zeichenfolge Ressourcen-ID, nIDPrompt, ist für den Hilfekontext verwendet. Weitere Informationen zum Hilfe Kontexte definieren, finden Sie im Artikel Hilfethemen in Visual C++ Programmer's Guide und technische Anmerkung 28.nbsp;
Siehe auch&Nbsp;CWnd::MessageBox