在屏幕上显示一个消息框。
int AfxMessageBox( ); int AFXAPI AfxMessageBox( ) -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() | 是模态对话框 |