Freigeben über


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

Siehe auch

Referenz

CWnd::MessageBox

Konzepte

MFC-Makros, globale Funktionen und globale Variablen