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