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 键不起作用。

功能 AfxFormatString1AfxFormatString2 很有用。显示在消息框中设置文本的格式。

备注

此重载函数的第一个窗体显示文本字符串指向由在消息框中 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

请参见

参考

CWnd::MessageBox

概念

MFC宏和Globals