在对话框中显示消息,等待用户单击按钮,并返回一个值指示用户单击的按钮。

MsgBox(prompt[, buttons][, title][, helpfile, context])

参数

prompt

作为消息显示在对话框中的字符串表达式prompt 的最大长度大约是 1024 个字符,这取决于所使用的字符的宽度。如果 prompt 中包含多个行,则可在各行之间用回车符 (Chr(13))、换行符 (Chr(10)) 或回车换行符的组合 (Chr(13) & Chr(10)) 分隔各行。

Buttons

数值表达式,是表示指定显示按钮的数目和类型、使用的图标样式,默认按钮的标识以及消息框样式的数值的总和。有关数值,请参阅“设置”部分。如果省略,则 buttons 的默认值为 0。

Title

显示在对话框标题栏中的字符串表达式。如果省略 title,则将应用程序的名称显示在标题栏中。

Helpfile

字符串表达式,用于标识为对话框提供上下文相关帮助的帮助文件。如果已提供 helpfile,则必须提供 context。在 16 位系统平台上不可用。

Context

数值表达式,用于标识由帮助文件的作者指定给某个帮助主题的上下文编号。如果已提供 context,则必须提供 helpfile。在 16 位系统平台上不可用。

设置

buttons 参数可以有以下值:

常数描述
vbOKOnly0只显示确定按钮。
vbOKCancel1显示确定取消按钮。
vbAbortRetryIgnore2显示放弃重试忽略按钮。
vbYesNoCancel3显示取消按钮。
vbYesNo4显示按钮。
vbRetryCancel5显示重试取消按钮。
vbCritical16显示临界信息图标。
vbQuestion32显示警告查询图标。
vbExclamation48显示警告消息图标。
vbInformation64显示信息消息图标。
vbDefaultButton10第一个按钮为默认按钮。
vbDefaultButton2256第二个按钮为默认按钮。
vbDefaultButton3512第三个按钮为默认按钮。
vbDefaultButton4768第四个按钮为默认按钮。
vbApplicationModal0应用程序模式:用户必须响应消息框才能继续在当前应用程序中工作。
vbSystemModal4096系统模式:在用户响应消息框前,所有应用程序都被挂起。

第一组值 (0 - 5) 用于描述对话框中显示的按钮类型与数目;第二组值 (16, 32, 48, 64) 用于描述图标的样式;第三组值 (0, 256,
512) 用于确定默认按钮;而第四组值 (0, 4096) 则决定消息框的样式。在将这些数字相加以生成 buttons
参数值时,只能从每组值中取用一个数字。

返回值

MsgBox 函数有以下返回值:

常数按钮
vbOK1确定
vbCancel2取消
vbAbort3放弃
vbRetry4重试
vbIgnore5忽略
vbYes6
vbNo7

说明

如果同时提供了 helpfilecontext,则用户可以按 F1
键以查看与上下文相对应的帮助主题。

如果对话框显示取消按钮,则按 ESC
键与单击取消的效果相同。如果对话框包含帮助按钮,则有为对话框提供的上下文相关帮助。但是在单击其他按钮之前,不会返回任何值。

当MicroSoft Internet
Explorer使用MsgBox函数时,任何对话框的标题总是包含"VBScript",以便于将其与标准对话框区别开来。

下面的例子演示了 MsgBox 函数的用法:

Dim MyVar
MyVar = MsgBox ("Hello World!", 65, "MsgBox Example")
   ' MyVar contains either 1 or 2, depending on which button is clicked.
05-11 13:48