Windows API (DAY04) MessageBox 函数

为了显示提示信息给用户，Windows 是提供了一个非常方便的 API 函数 MessageBox
给用户使用，使用这个 API 函数可以显示简单的文字信息出来，提醒或提示用户进行下一步操作。
函数声明如下：
WINUSERAPI 9
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 是按钮

演示例子如下：
Windows API (DAY04) MessageBox 函数
上面显示的代码是：

#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 11
MB_YESNO MB_YESNOCANCEL

图标类型： MB_ICONEXCLAMATION MB_ICONWARNING MB_ICONINFORMAT ION 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

Windows API (DAY04) MessageBox 函数

相关推荐