MsgBox 函數(shù)
在對(duì)話框中顯示消息,等待用戶單擊按鈕,并返回一個(gè)值指示用戶單擊的按鈕。
MsgBox(prompt[, buttons][, title][, helpfile, context])
參數(shù)
prompt
作為消息顯示在對(duì)話框中的字符串表達(dá)式。prompt 的最大長(zhǎng)度大約是 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ù)值,請(qǐng)參閱“設(shè)置”部分。如果省略,則 buttons 的默認(rèn)值為 0。
Title
顯示在對(duì)話框標(biāo)題欄中的字符串表達(dá)式。如果省略 title,則將應(yīng)用程序的名稱顯示在標(biāo)題欄中。
Helpfile
字符串表達(dá)式,用于標(biāo)識(shí)為對(duì)話框提供上下文相關(guān)幫助的幫助文件。如果已提供 helpfile,則必須提供 context。在 16 位系統(tǒng)平臺(tái)上不可用。
Context
數(shù)值表達(dá)式,用于標(biāo)識(shí)由幫助文件的作者指定給某個(gè)幫助主題的上下文編號(hào)。如果已提供 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) 用于描述對(duì)話框中顯示的按鈕類型與數(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 鍵以查看與上下文相對(duì)應(yīng)的幫助主題。
如果對(duì)話框顯示取消按鈕,則按 ESC 鍵與單擊取消的效果相同。如果對(duì)話框包含幫助按鈕,則有為對(duì)話框提供的上下文相關(guān)幫助。但是在單擊其他按鈕之前,不會(huì)返回任何值。
當(dāng)MicroSoft Internet Explorer使用MsgBox函數(shù)時(shí),任何對(duì)話框的標(biāo)題總是包含"VBScript",以便于將其與標(biāo)準(zhǔn)對(duì)話框區(qū)別開來。
下面的例子演示了 MsgBox 函數(shù)的用法:
Dim MyVar
MyVar = MsgBox ("Hello World!", 65, "MsgBox Example")
' MyVar contains either 1 or 2, depending on which button is clicked