AfxMessageBox

Displays a message box on the screen.

int AfxMessageBox(
   LPCTSTR lpszText,
   UINT nType = MB_OK,
   UINT nIDHelp = 0 
);
int AFXAPI AfxMessageBox(
   UINT nIDPrompt,
   UINT nType = MB_OK,
   UINT nIDHelp = (UINT
) -1 
);

Parameters

  • lpszText
    Points to a CString object or null-terminated string containing the message to be displayed in the message box.

  • nType
    The style of the message box. Apply any of the message-box styles to the box.

  • nIDHelp
    The Help context ID for the message; 0 indicates the application's default Help context will be used.

  • nIDPrompt
    A unique ID used to reference a string in the string table.

Return Value

Zero if there is not enough memory to display the message box; otherwise, one of the following values is returned:

  • IDABORT   The Abort button was selected.

  • IDCANCEL   The Cancel button was selected.

  • IDIGNORE   The Ignore button was selected.

  • IDNO   The No button was selected.

  • IDOK   The OK button was selected.

  • IDRETRY   The Retry button was selected.

  • IDYES   The Yes button was selected.

If a message box has a Cancel button, the IDCANCEL value will be returned if either the ESC key is pressed or the Cancel button is selected. If the message box has no Cancel button, pressing the ESC key has no effect.

The functions AfxFormatString1 and AfxFormatString2 can be useful in formatting text that appears in a message box.

Remarks

The first form of this overloaded function displays a text string pointed to by lpszText in the message box and uses nIDHelp to describe a Help context. The Help context is used to jump to an associated Help topic when the user presses the Help key (typically F1).

The second form of the function uses the string resource with the ID nIDPrompt to display a message in the message box. The associated Help page is found through the value of nIDHelp. If the default value of nIDHelp is used (– 1), the string resource ID, nIDPrompt, is used for the Help context. For more information about defining Help contexts, see Technical Note 28.

Example

// 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);

Requirements

Header: afxwin.h

See Also

Concepts

MFC Macros and Globals

CWnd::MessageBox