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 引用一个在字符串表中。
返回值
零,如果未显示消息框足够的内存;否则,下列值之一返回:
IDABORT 中止按钮的部分。
IDCANCEL 取消按钮的部分。
IDIGNORE 忽略按钮的部分。
IDNO 不按钮的部分。
IDOK " 确定 " 按钮的部分。
IDRETRY 重试 " 按钮的部分。
IDYES 是按钮的部分。
如果消息框包含 " 取消 " 按钮, IDCANCEL 值将返回; 如果或 ESC 键按下或取消按钮被选定。如果消息框没有 " 取消 " 按钮,按 ESC 键不起作用。
功能 AfxFormatString1 和 AfxFormatString2 很有用。显示在消息框中设置文本的格式。
备注
此重载函数的第一个窗体显示文本字符串指向由在消息框中 lpszText 并使用 nIDHelp 描述帮助上下文。帮助上下文用于跳转到相关帮助主题,当用户按帮助键时 (通常为 F1)。
函数的第二个窗体使用与 id(-4) nIDPrompt 的字符串资源在消息框中显示一条消息。关联帮助页。 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);
要求
Header: afxwin.h