在屏幕上显示一个消息框。
|
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++ |
|
|
// 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
参考阅读
Messagebox和AfxMessageBox的区别
|
AfxMessageBox |
Messagebox |
|
全局的对话框，是MFC的API |
Win32API函数 |
|
可以用于任何程序 |
只能用在CWnd及其派生类中 |
|
不能任意设置标题 |
可以任意设置标题 |
|
常用于调试程序时的内部数据输出或警告 |
常用在要提交的应用程序版本中，可以控制标题内容而不必采用含义不明的可执行文件名为标题 |
|
不会挂起线程 |
会挂起线程 等待确认后 继续 |
|
最终结果是调用 :windowsAPI MessageBox（） |
是模态对话框 |