在屏幕上显示一个消息框。
| 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对象或非空字符串的指针，消息框上显示内容就是cstring对象或非空字符串。
nType
消息框的风格。按钮风格和图标风格的组合，可以采用|（或）操作符组合各种风格。消息框的在这里都适用，如下：
按钮风格
| MB_ABORTRETRYIGNORE | 消息框中显示Abort、Retry、Ignore按钮 |
| MB_OK | 显示OK按钮 |
| MB_OKCANCEL | 显示OK、Cancel按钮 |
| MB_RETRYCANCEL | 显示Retry、Cancel按钮 |
| MB_YESNO | 显示Yes、No按钮 |
| MB_YESNOCANC | 显示Yes、No、Cancel按钮 |
图标风格
| MB_ICONINFORMATION | 显示一个i图标，表示提示 |
| MB_ICONEXCLAMATION | 显示一个惊叹号，表示警告 |
| MB_ICONSTOP | 显示手形图标，表示警告或严重错误 |
| MB_ICONQUESTION | 显示问号图标，表示疑问 |
nIDHelp
消息的帮助文本ID；0是默认的帮助内容。
nIDPrompt
字符串表里的标识字符串的ID。
返回值
内存不够返回0；否则是下面的一个：
- IDABORT 选择了退出按钮。
- IDCANCEL 选择了取消按钮
- IDIGNORE 选择忽略按钮
- IDNO 没选择任何按钮
- IDOK 选择OK按钮
- IDRETRY .选择重试按钮
- IDYES 选择YES按钮
如果消息框有一个取消按钮，当按下ESC键或点击取消按钮，返回值就是IDCANCEL。如果消息框没有取消按钮，按ESC没有效果。
函数AfxFormatString1和AfxFormatString2在格式化文本方面很方便。
备注
第一个函数显示消息文本通过lpszText并且使用nIDHelp来描述帮助信息。帮助信息在按下帮助键（如F1）的时候可以跳转到对应的主题。
第二个函数显示的字符串通过nIDPrompt来引用资源。帮助页面通过nIDHelp来链接。默认值是-1，字符串资源的ID，nIDPrompt，就用做是帮助信息。阅读Technical Note 28了解更多关于如何定义帮助信息。
代码示例
| Visual C++ | Copy Code |
| // 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
参考阅读
MFC Macros and Globals
CWnd::MessageBox
Messagebox和AfxMessageBox的区别
| AfxMessageBox | Messagebox |
| 全局的对话框，是MFC的API | Win32API函数 |
| 可以用于任何程序 | 只能用在CWnd及其派生类中 |
| 不能任意设置标题 | 可以任意设置标题 |
| 常用于调试程序时的内部数据输出或警告 | 常用在要提交的应用程序版本中，可以控制标题内容而不必采用含义不明的可执行文件名为标题 |
| 不会挂起线程 | 会挂起线程 等待确认后 继续 |
| 最终结果是调用 :windowsAPI MessageBox（） | 是模态对话框 |