Microsoft® Visual Basic® Scripting Edition
MsgBox 函数
 程式语言叁考 
  | Version 1 

请叁阅


说明
将讯息显示在对话方块中,等使用者按下按钮,并传回一值来表示使用者按下的是那一个钮。
语法
MsgBox(prompt[, buttons][, title][, helpfile, context])

MsgBox 函数语法有下列的指名引数:

组成部分 说明
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 的设定有以下几个:

常数 说明
vbOKOnly    0 只显示「确定」按钮。
vbOKCancel    1 显示「确定」「取消」按钮。
vbAbortRetryIgnore    2 显示「放弃」「重试」「忽略」按钮。
vbYesNoCancel    3 显示「是」「否」「取消」按钮。
vbYesNo    4 显示「是」「否」按钮。
vbRetryCancel    5 显示「重试」「取消」按钮。
vbCritical   16 显示「重要讯息」图示。
vbQuestion   32 显示「问号符号」图示。
vbExclamation   48 显示「警告符号」图示。
vbInformation   64 显示「资讯符号」图示。
vbDefaultButton1    0 第一个按钮是预设值。
vbDefaultButton2  256 第二个按钮 是预设值。
vbDefaultButton3  512 第三个按钮是预设值。
vbDefaultButton4  768 第四个按钮是预设值。
vbApplicationModal    0 用程式强制回应;使用者必须先回应此讯息方块,才能在目前的应用程式中继续工作。
vbSystemModal 4096 系统强制回应;所有的应用程式都会暂停,直到使用者回应此讯息方块。

第一组值 (0-5) 用来决定对话方块中按钮的形式与数目;第二组 (16, 32, 48, 64) 用来决定图示的样式;第三组 (0, 256, 512) 决定出那一个按钮是预设值;而第四组 (0, 4096) 则决定讯息方块的强制回应性。将这些数字相加以产生 buttons, 引数值的时候,您只能由每组取用一个数字。

传回值
MsgBox 函数有下列传回值:

常数 按钮
vbOK 1 「确定」
vbCancel 2 「取消」
vbAbort 3 「放弃」
vbRetry 4 「重试」
vbIgnore 5 「忽略」
vbYes 6 「是」
vbNo 7 「否」

注解
如果同时指定了 helpfilecontext ,使用者便可以按 F1 来查看与 context 相关的说明主题。

如果对话方块有显示 Cancel 按钮,则按下 ESC 键与按下 Cancel. 按钮效果相同。如果对话方块中有 Help 按钮,则对话方块中提供有文字感应说明。无论如何,在其他按钮中的一个被按下前,不会传回任何值。