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 einem CString-Objekt oder eine auf NULL endende Zeichenfolge, die die im Meldungsfeld anzuzeigenden Meldung enthalten.nType
Das Format des Meldungsfelds.Wenden Sie Meldungsfeld Spaltenformate auf das Feld angewendet.nIDHelp
Die Hilfe kontext-id für die Meldung. 0 gibt den Hilfekontext der Anwendung verwendet wird.nIDPrompt
Eine eindeutige Identifikationsnummer verwendet, um eine Zeichenfolge in der Zeichenfolgentabelle zu verweisen.
Rückgabewert
Beliebige wenn nicht genügend Arbeitsspeicher vorhanden, um das Meldungsfeld anzuzeigen; andernfalls wird einer der folgenden Werte zurückgegeben:
IDABORT die Schaltfläche Abbruch ausgewählt wurde.
IDCANCEL die Schaltfläche Abbrechen ausgewählt wurde.
IDIGNORE die Schaltfläche Ignorierungs ausgewählt wurde.
IDNO die keine Schaltfläche ausgewählt wurde.
IDOK die Schaltfläche OK ausgewählt wurde.
IDRETRY die Schaltfläche Wiederholen ausgewählt wurde.
IDYES die Schaltfläche Ja aktiviert wurde.
Wenn ein Meldungsfeld eine Schaltfläche Abbrechen verfügt, wird der IDCANCEL-Wert zurückgegeben, wenn die ESC-Taste gedrückt wird oder die Schaltfläche Abbrechen ausgewählt ist.Wenn das Meldungsfeld keine Schaltfläche Abbrechen verfügt, wirkt sich das Drücken der ESC-TASTE keine Auswirkungen.
Die Funktionen AfxFormatString1 und AfxFormatString2 können im die Formatierung von Text nützlich sein, der in einem Meldungsfeld angezeigt.
Hinweise
Die erste Form dieser überladenen Funktion zeigt eine Zeichenfolge an, die durch lpszText im Meldungsfeld angezeigt wird und verwendet, um einen nIDHelp Hilfekontext zu beschreiben.Der Hilfekontext wird ein zugeordnetes Hilfethema zu springen, wenn der Benutzer die Hilfetaste F1 drückt (i).
Die zweite Form der Funktion verwendet die Zeichenfolgenressource mit der ID nIDPrompt, um eine Meldung im Meldungsfeld angezeigt werden soll.Die zugeordnete Hilfeseite wird durch den Wert von nIDHelp gefunden.Wenn der Standardwert verwendet wird nIDHelp (– 1), die Zeichenfolgenressource ID, nIDPrompt, wird für den Hilfekontext verwendet.Weitere Informationen über das Definieren von Hilfe kontexten 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