AfxMessageBox
显示屏幕上的消息框。
int AfxMessageBox(
LPCTSTR lpszText,
UINT nType = MB_OK,
UINT nIDHelp = 0
);
int AFXAPI AfxMessageBox(
UINT nIDPrompt,
UINT nType = MB_OK,
UINT nIDHelp = (UINT
) -1
);
参数
lpszText
指向 CString 对象或以 NULL 结尾的字符串，这类字符串包含在消息框中显示的消息。nType
消息框的样式。 应用所有消息框样式到框。nIDHelp
消息的帮助上下文 ID；0 说明将使用应用程序的默认值帮助上下文。nIDPrompt
用于在字符串表中引用一个字符串的唯一 ID。
返回值
如果没有足够的内存显示消息框，则返回 0；否则，将返回下列值之一：
IDABORT 已选择“中止”按钮。
IDCANCEL 已选择“取消”按钮。
IDIGNORE 已选择“忽略”按钮。
IDNO 已选择“否”按钮。
IDOK 已选择“确定”按钮。
IDRETRY 已选择“重试”按钮。
IDYES 已选择“是”按钮。
如果一个消息框包含“取消”按钮，则无论按下 ESC 键或选择“取消”按钮，都将返回 IDCancel 值。 如果消息框没有“取消”按钮，按 ESC 键不会起作用。
为显示在消息框中的文本进行格式设置时，功能 AfxFormatString1 和 AfxFormatString2 将很实用。
备注
此重载函数的第一个窗体显示消息框中 lpszText 指向的文本字符串，并使用 nIDHelp 来描述帮助上下文。 当用户按帮助键时（通常为 F1），帮助上下文可用于跳转到一个相关帮助主题。
函数的第二种形式通过 nIDPrompt ID 使用字符串资源，以便在消息框中显示消息。 从 nIDHelp 的值中可以找到关联帮助页。 如果使用 nIDHelp 的默认值 (– 1)，则字符串资源 ID (nIDPrompt) 用于帮助上下文。 有关定义帮助上下文的更多信息，请参见技术说明 28。
示例
// 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);
要求
标头: afxwin.h