MsgBox 函數(shù)

在對話框中顯示消息，等待用戶單擊按鈕，并返回一個(gè) Integer 告訴用戶單擊哪一個(gè)按鈕。

語法

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

MsgBox 函數(shù)的語法具有以下幾個(gè)命名參數(shù)：

部分 描述
Prompt 必需的。字符串表達(dá)式，作為顯示在對話框中的消息。prompt 的最大長度大約為 1024 個(gè)字符，由所用字符的寬度決定。如果 prompt 的內(nèi)容超過一行，則可以在每一行之間用回車符 (Chr(13))、換行符 (Chr(10)) 或是回車與換行符的組合 (Chr(13) & Chr(10)) 將各行分隔開來。
Buttons 可選的。數(shù)值表達(dá)式是值的總和，指定顯示按鈕的數(shù)目及形式，使用的圖標(biāo)樣式，缺省按鈕是什么以及消息框的強(qiáng)制回應(yīng)等。如果省略，則 buttons 的缺省值為 0。
Title 可選的。在對話框標(biāo)題欄中顯示的字符串表達(dá)式。如果省略 title，則將應(yīng)用程序名放在標(biāo)題欄中。
Helpfile 可選的。字符串表達(dá)式，識(shí)別用來向?qū)υ捒蛱峁┥舷挛南嚓P(guān)幫助的幫助文件。如果提供了 helpfile，則也必須提供 context。
Context 可選的。數(shù)值表達(dá)式，由幫助文件的作者指定給適當(dāng)?shù)膸椭黝}的幫助上下文編號。如果提供了 context，則也必須提供 helpfile。

設(shè)置值

buttons 參數(shù)有下列設(shè)置值：

常數(shù) 值 描述
vbOKOnly 0 只顯示 OK 按鈕。
VbOKCancel 1 顯示 OK 及 Cancel 按鈕。
VbAbortRetryIgnore 2 顯示 Abort、Retry 及 Ignore 按鈕。
VbYesNoCancel 3 顯示 Yes、No 及 Cancel 按鈕。
VbYesNo 4 顯示 Yes 及 No 按鈕。
VbRetryCancel 5 顯示 Retry 及 Cancel 按鈕。
VbCritical 16 顯示 Critical Message 圖標(biāo)。
VbQuestion 32 顯示 Warning Query 圖標(biāo)。
VbExclamation 48 顯示 Warning Message 圖標(biāo)。
VbInformation 64 顯示 Information Message 圖標(biāo)。
vbDefaultButton1 0 第一個(gè)按鈕是缺省值。
vbDefaultButton2 256 第二個(gè)按鈕是缺省值。
vbDefaultButton3 512 第三個(gè)按鈕是缺省值。
vbDefaultButton4 768 第四個(gè)按鈕是缺省值。

vbApplicationModal 0 應(yīng)用程序強(qiáng)制返回；應(yīng)用程序一直被掛起，直到用戶對消息框作出響應(yīng)才繼續(xù)工作。
vbSystemModal 4096 系統(tǒng)強(qiáng)制返回；全部應(yīng)用程序都被掛起，直到用戶對消息框作出響應(yīng)才繼續(xù)工作。
vbMsgBoxHelpButton 16384 將Help按鈕添加到消息框
VbMsgBoxSetForeground 65536 指定消息框窗口作為前景窗口
vbMsgBoxRight 524288 文本為右對齊
vbMsgBoxRtlReading 1048576 指定文本應(yīng)為在希伯來和阿拉伯語系統(tǒng)中的從右到左顯示

第一組值 (0–5) 描述了對話框中顯示的按鈕的類型與數(shù)目；第二組值 (16, 32, 48, 64) 描述了圖標(biāo)的樣式；第三組值 (0, 256, 512) 說明哪一個(gè)按鈕是缺省值；而第四組值 (0, 4096) 則決定消息框的強(qiáng)制返回性。將這些數(shù)字相加以生成 buttons 參數(shù)值的時(shí)候，只能由每組值取用一個(gè)數(shù)字。

注意 這些常數(shù)都是 Visual Basic for Applications (VBA) 指定的。結(jié)果，可以在程序代碼中到處使用這些常數(shù)名稱，而不必使用實(shí)際數(shù)值。

返回值

常數(shù) 值 描述
vbOK 1 OK
vbCancel 2 Cancel
vbAbort 3 Abort
vbRetry 4 Retry
vbIgnore 5 Ignore
vbYes 6 Yes
vbNo 7 No

說明

在提供了 helpfile 與 context 的時(shí)候，用戶可以按 F1 來查看與 context 相應(yīng)的幫助主題。像 Microsoft Excel 這樣一些主機(jī)應(yīng)用程序也會(huì)在對話框中自動(dòng)添加一個(gè) Help 按鈕。

如果對話框顯示 Cancel 按鈕，則按下 ESC 鍵與單擊 Cancel 按鈕的效果相同。如果對話框中有 Help 按鈕，則對話框中提供有上下文相關(guān)的幫助。但是，直到其它按鈕中有一個(gè)被單擊之前，都不會(huì)返回任何值。

注意 如果還要指定第一個(gè)命名參數(shù)以外的參數(shù)，則必須在表達(dá)式中使用 MsgBox。為了省略某些位置參數(shù)，必須加入相應(yīng)的逗號分界符。

　　MsgBox 函數(shù)

　　在對話框中顯示消息，等待用戶單擊按鈕，并返回一個(gè)值指示用戶單擊的按鈕。

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

參數(shù)

prompt

作為消息顯示在對話框中的字符串表達(dá)式。prompt 的最大長度大約是 1024 個(gè)字符，這取決于所使用的字符的寬度。如果 prompt 中包含多個(gè)行，則可在各行之間用回車符 (Chr(13))、換行符 (Chr(10)) 或回車換行符的組合 (Chr(13) & Chr(10)) 分隔各行。

Buttons

數(shù)值表達(dá)式，是表示指定顯示按鈕的數(shù)目和類型、使用的圖標(biāo)樣式，默認(rèn)按鈕的標(biāo)識(shí)以及消息框樣式的數(shù)值的總和。有關(guān)數(shù)值，請參閱“設(shè)置”部分。如果省略，則 buttons 的默認(rèn)值為 0。

Title

顯示在對話框標(biāo)題欄中的字符串表達(dá)式。如果省略 title，則將應(yīng)用程序的名稱顯示在標(biāo)題欄中。

Helpfile

字符串表達(dá)式，用于標(biāo)識(shí)為對話框提供上下文相關(guān)幫助的幫助文件。如果已提供 helpfile，則必須提供 context。在 16 位系統(tǒng)平臺(tái)上不可用。

Context

數(shù)值表達(dá)式，用于標(biāo)識(shí)由幫助文件的作者指定給某個(gè)幫助主題的上下文編號。如果已提供 context，則必須提供 helpfile。在 16 位系統(tǒng)平臺(tái)上不可用。
設(shè)置

buttons 參數(shù)可以有以下值：

常數(shù) 值 描述
vbOKOnly 0 只顯示確定按鈕。
vbOKCancel 1 顯示確定和取消按鈕。
vbAbortRetryIgnore 2 顯示放棄、重試和忽略按鈕。
vbYesNoCancel 3 顯示是、否和取消按鈕。
vbYesNo 4 顯示是和否按鈕。
vbRetryCancel 5 顯示重試和取消按鈕。
vbCritical 16 顯示臨界信息圖標(biāo)。
vbQuestion 32 顯示警告查詢圖標(biāo)。
vbExclamation 48 顯示警告消息圖標(biāo)。
vbInformation 64 顯示信息消息圖標(biāo)。
vbDefaultButton1 0 第一個(gè)按鈕為默認(rèn)按鈕。
vbDefaultButton2 256 第二個(gè)按鈕為默認(rèn)按鈕。
vbDefaultButton3 512 第三個(gè)按鈕為默認(rèn)按鈕。
vbDefaultButton4 768 第四個(gè)按鈕為默認(rèn)按鈕。
vbApplicationModal 0 應(yīng)用程序模式：用戶必須響應(yīng)消息框才能繼續(xù)在當(dāng)前應(yīng)用程序中工作。
vbSystemModal 4096 系統(tǒng)模式：在用戶響應(yīng)消息框前，所有應(yīng)用程序都被掛起。

第一組值 (0 - 5) 用于描述對話框中顯示的按鈕類型與數(shù)目；第二組值 (16, 32, 48, 64) 用于描述圖標(biāo)的樣式；第三組值 (0, 256, 512) 用于確定默認(rèn)按鈕；而第四組值 (0, 4096) 則決定消息框的樣式。在將這些數(shù)字相加以生成 buttons 參數(shù)值時(shí)，只能從每組值中取用一個(gè)數(shù)字。

返回值

MsgBox 函數(shù)有以下返回值：

　　常數(shù) 值 按鈕
vbOK 1 確定
vbCancel 2 取消
vbAbort 3 放棄
vbRetry 4 重試
vbIgnore 5 忽略
vbYes 6 是
vbNo 7 否

說明

如果同時(shí)提供了 helpfile 和 context，則用戶可以按 F1 鍵以查看與上下文相對應(yīng)的幫助主題。

如果對話框顯示取消按鈕，則按 ESC 鍵與單擊取消的效果相同。如果對話框包含幫助按鈕，則有為對話框提供的上下文相關(guān)幫助。但是在單擊其他按鈕之前，不會(huì)返回任何值。

當(dāng)MicroSoft Internet Explorer使用MsgBox函數(shù)時(shí)，任何對話框的標(biāo)題總是包含"VBScript",以便于將其與標(biāo)準(zhǔn)對話框區(qū)別開來。

下面的例子演示了 MsgBox 函數(shù)的用法：

Dim MyVar
MyVar = MsgBox ("Hello World!", 65, "MsgBox Example")
' MyVar contains either 1 or 2, depending on which button is clicked