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对象或非空字符串的指针，消息框上显示内容就是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（）	是模态对话框