为了显示提示信息给用户,Windows 是提供了一个非常方便的 API 函数 MessageBox给用户使用,使用这个 API 函数可以显示简单的文字信息出来,提醒或提示用户进行下一 步操作。函数声明如下:
WINUSERAPI
int WINAPI MessageBoxA(
in_opt HW ND hWnd,
in_opt LPCSTR lpText,
in_opt LPCSTR lpCaption,
in UINT uType);
WINUSERAPI
int WINAPI MessageBoxW(
in_opt HWND hWnd,
in_opt LPCWSTR lpText,
in_opt LPCWSTR lpCaption,
in UINT uType);
#ifdef UNICODE
#define MessageBox MessageBoxW
#else
#define MessageBox MessageBoxA
#endif // !UNICODE
从上面可以看出,Windows 的 API 是两种声明,一种是使用到 ANSI 编码,一种是使 用到 UNICODE 编码的 API 函数。通过宏定义把这两种 API 名称统一到 MessageBox 的声明。这是一种使用选择不同 API 的技术,在今后的编程里,大多数都需要使用 UNICODE编码了,因为可以适应不同国家的语言显示,可以国际化编程,特别对于中文支持更加需要UNICODE 编程。 下面来解释一下参数的定义:
- hWnd 是指向父窗口的句柄,如果没有父窗口,可以把这个参数设置为 NULL。
- lpText 是需要显示的文字。显示字符串的起始地址。
- lpCaption 是在窗口上标题显示。
- uType 是窗口组合按钮和显示图标的类型。后面再详细说明。
返回值是一个整数,如果有取消按钮,并且按下 ESC 键就返回 IDCANCEL。如果有其 它按钮,并且按下,就返回相应的值。主要的值如下:
- IDABORT 放弃按钮
- IDCANCEL 取消按钮
- IDCONTINUE 继续按钮
- IDIGNORE 忽略按钮
- IDNO 否按钮
- IDOK 确定按钮
- IDRETRY 重试按钮
- IDTRYAGAIN 重试按钮
- IDYES 是按钮
演示例子如下:
上面显示的代码是:
#001 //MB_DEFBUTTO N4
#002 int C MsgBox ::Sho w_MB_DEFBUTTO N4(vo id)
#003 {
#004 //显示 MB_DEFBUTTO N4。
#005 re turn ::Messa geBox (NULL, _T("MB_YESNOC ANC EL|MB_DEFBUTTO N4|MB_HELP "),
#006 _T("第一个应用程序"), MB_YESNOC ANC EL|MB_DEFBUTTO N4|MB_HELP|MB_ICO NQ UESTIO N);
#007 }
uType 常用的选择值如下:
按钮类型
MB_ABORTRETRYIGNORE
- MB_CANCELTRYCONTINUE
- MB_HELP
- MB_OK
- MB_OKCANCEL
- MB_RETRYCANCEL
- MB_YESNO
- MB_YESNOCANCEL
图标类型
- MB_ICONEXCLAMATION
- MB_ICONWARNING
- MB_ICONINFORMATION
- MB_ICONASTERISK
- MB_ICONQUESTION
- MB_ICONSTOP
- MB_ICONERROR
- MB_ICONHAND
设置缺省按钮值
- MB_DEFBUTTON1
- MB_DEFBUTTON2
- MB_DEFBUTTON3
- MB_DEFBUTTON4
修改显示信息窗口的属性
- MB_APPLMODAL
- MB_SYSTEMMODAL
- MB_TASKMODAL
- MB_RIGHT
- MB_RTLREADING
- MB_SETFOREGROUND
- MB_TOPMOST
- MB_SERVICE_NOTIFICATION