AfxMessageBox
Zeigt ein Meldungsfeld auf dem Bildschirm an.
int AfxMessageBox(
LPCTSTR lpszText,
UINT nType = MB_OK,
UINT nIDHelp = 0
);
int AFXAPI AfxMessageBox(
UINT nIDPrompt,
UINT nType = MB_OK,
UINT nIDHelp = (UINT
) -1
);
Parameter
lpszText
Zeigt auf ein CString-Objekt oder auf eine auf NULL endende Zeichenfolge, worin die im Meldungsfeld anzuzeigende Meldung enthalten ist.nType
Der Stil des Meldungsfelds. Wenden Sie einen beliebigen der Meldungsfeldstile auf das Feld an.nIDHelp
Die Hilfekontext-ID für die Meldung; 0 gibt an, dass der Standardhilfekontext der Anwendung verwendet wird.nIDPrompt
Eine eindeutige ID, die verwendet wird, um auf eine Zeichenfolge in der Zeichenfolgentabelle zu verweisen.
Rückgabewert
Null (0), wenn nicht genügend Arbeitsspeicher vorhanden ist, um des Meldungsfelds anzuzeigen; andernfalls wird einer der folgenden Werte zurückgegeben:
IDABORT Die Schaltfläche "Beenden" wurde ausgewählt.
IDCANCEL Die Schaltfläche "Abbrechen" wurde ausgewählt.
IDIGNORE Die Schaltfläche "Ignorieren" wurde ausgewählt.
IDNO Die Schaltfläche "Nein" wurde ausgewählt.
IDOK Die Schaltfläche "OK" wurde ausgewählt.
IDRETRY Die Schaltfläche "Wiederholen" wurde ausgewählt.
IDYES Die Schaltfläche "Ja" wurde ausgewählt.
Sofern ein Meldungsfeld über die Schaltfläche "Abbrechen" verfügt, wird der IDCANCEL-Wert zurückgegeben, wenn entweder die ESC-TASTE gedrückt oder die Schaltfläche "Abbrechen" gewählt wird. Enthält das Meldungsfeld keine Schaltfläche "Abbrechen", hat das Drücken der ESC-TASTE keine Auswirkung.
Die Funktionen AfxFormatString1 und AfxFormatString2 können nützlich sein, um den Text zu formatieren, der in einem Meldungsfeld angezeigt wird.
Hinweise
Mit der ersten Form dieser überladenen Funktion wird eine Textzeichenfolge angezeigt, auf die durch lpszText im Meldungsfeld verwiesen wird, und diese Form verwendet nIDHelp, um einen Hilfekontext zu beschreiben. Der Hilfekontext wird verwendet, um zu einem zugeordneten Hilfethema zu wechseln, wenn der Benutzer die Hilfetaste drückt (in der Regel F1).
Das zweite Form der Funktion verwendet die Zeichenfolgenressource mit der ID nIDPrompt, um eine Meldung im Meldungsfeld anzuzeigen. Die zugeordnete Hilfeseite wird über den Wert von nIDHelp gefunden. Bei Verwendung des Standardwerts nIDHelp (– 1) wird die Zeichenfolgenressource-ID nIDPrompt für den Hilfekontext verwendet. Weitere Informationen über das Definieren eines Hilfekontexts finden Sie unter Technischer Hinweis 28.
Beispiel
// 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);
Anforderungen
Header: afxwin.h