MessageBox
函数功能:
MessageBox 函数用于显示一个模态对话框,其中包含一个系统图标、 一组按钮和一个简短的特定于应用程序消息,如状态或错误的信息。
消息框中返回一个整数值,该值指示用户单击了哪个按钮。
API 函数原型:
注释:_In_ 说明该参数是输入的,_opt_ 说明该参数是可选参数。
- int WINAPI MessageBox(
- _In_opt_ HWND hWnd,
- _In_opt_ LPCTSTR lpText,
- _In_opt_ LPCTSTR lpCaption,
- _In_ UINT uType
- );
参数解析:
参数 | 含义 |
hWnd | 1. 该消息框的父窗口句柄 2. 如果此参数为NULL,则该消息框没有拥有父窗口 |
lpText | 消息框的内容 |
lpCaption | 消息框的标题 |
uType | 1. 指定一个决定对话框的内容和行为的位标志集 2. 此参数可以通过指定下列标志或标志的组合,来显示消息框中的按钮以及图标 |
uType参数定义解析
按钮 | 含义 |
MB_OK | 默认值,有一个“确认”按钮在里面 |
MB_YESNO | 有“是”和“否”两个按钮在里面 |
MB_ABORTRETRYIGNORE | 有“中止”,“重试”和“跳过”三个按钮在里面 |
MB_YESNOCANCEL | 有“是”,“否”和“取消”三个按钮在里面 |
MB_RETRYCANCEL | 有“重试”和“取消”两个按钮在里面 |
MB_OKCANCEL | 有“确定”和“取消”两个按钮在里面 |
图标 | 含义 |
MB_ICONEXCLAMATION | 一个惊叹号出现在消息框: <ignore_js_op> |
MB_ICONWARNING | 一个惊叹号出现在消息框(同上) |
MB_ICONINFORMATION | 一个圆圈中小写字母i组成的图标出现在消息框: <ignore_js_op> |
MB_ICONASTERISK | 一个圆圈中小写字母i组成的图标出现在消息框(同上) |
MB_ICONQUESTION | 一个问题标记图标出现在消息框: <ignore_js_op> |
MB_ICONSTOP | 一个停止消息图标出现在消息框: <ignore_js_op> |
MB_ICONERROR | 一个停止消息图标出现在消息框(同上) |
MB_ICONHAND | 一个停止消息图标出现在消息框(同上) |
默认按钮 | 含义 |
MB_DEFBUTTON1 | 指定第一个按钮为默认按钮 |
MB_DEFBUTTON2 | 指定第二个按钮为默认按钮 |
MB_DEFBUTTON3 | 指定第三个按钮为默认按钮 |
MB_DEFBUTTON4 | 指定第四个按钮为默认按钮 |
消息框形态 | 含义 |
MB_APPLMODAL | 1. 在 hWnd 参数标识的窗口中继续工作以前,用户一定响应消息框 2. 但是,用户可以移动到其他线程的窗口且在这些窗口中工作 3. 根据应用程序中窗口的层次机构,用户则以移动到线程内的其他窗口 4. 所有母消息框的子窗口自动地失效,但是弹出窗口不是这样 5. 如果既没有指定 MB_SYSTEMMODAL 也没有指定 MB_TASKMODAL,则 MB_APPLMODAL 为默认的 |
MB_SYSTEMMODAL | 1. 除了消息框有 WB_EX_TOPMOST 类型,否则 MB_APPLMODAL 和 MB_SYSTEMMODAL 一样 2. 用系统模态消息框来改变各种各样的用户,主要的损坏错误需要立即注意(例如,内存溢出) 3. 如果不是那些与 hWnd 联系的窗口,此标志对用户对窗口的相互联系没有影响 |
MB_TASKMODAL | 1. 如果参数 hWnd 为 NULL 的话,那么除了所有属于当前线程高层次的窗口失效外,MB_TASKMODAL 和 MB_APPLMODAL 一样 2. 当调用应用程序或库没有一个可以得到的窗口句柄时,可以使用此标志,但仍需要阻止输入到调用线程的其他窗口,而不是搁置其他线程 |
其他标志 | 含义 |
MB_DEFAULT_DESKTOP_ONLY | 1. 接收输入的当前桌面一定是一个默认桌面,否则函数调用失败 2. 默认桌面是一个在用户已经记录且以后应用程序在此上面运行的桌面 |
MB_HELP | 1. 把一个 Help 按钮增加到消息框 2. 选择 Help 按钮或按 F1 产生一个 Help 事件 |
MB_RIGHT | 文本为右对齐 |
MB_RTLREADING | 用在 Hebrew 和 Arabic 系统中从右到左的顺序显示消息和大写文本 |
MB_SETFOREGROUND | 1. 消息框变为前景窗口 2. 在内部系统为消息个调用 SetForegroundWindow 函数 |
MB_TOPMOST | 消息框用 WS_EX_TOPMOST 窗口类型来创建 MB_SERVICE_NOTIFICATION |
返回值:
返回值 | 含义 |
IDOK | 用户按下了“确认”按钮 |
IDCANCEL | 用户按下了“取消”按钮 |
IDABORT | 用户按下了“中止”按钮 |
IDRETRY | 用户按下了“重试”按钮 |
IDIGNORE | 用户按下了“忽略”按钮 |
IDYES | 用户按下了“是”按钮 |
IDNO | 用户按下了“否”按钮 |
举例:
- #include <windows.h>
- int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow)
- {
- MessageBox(NULL, TEXT("这是我在鱼C学的第一个程序!"), TEXT("打招呼"), MB_OKCANCEL | MB_ICONQUESTION | MB_DEFBUTTON2);
- return 0;
- }
<ignore_js_op>
【API档案】版权归鱼C工作室(www.fishc.com)所有,转载请注明来源。