Visual Basic Scripting Edition | 語(yǔ)言參考 |
在對(duì)話框中顯示消息,等待用戶單擊按鈕,并返回一個(gè)值指示用戶單擊的按鈕。
MsgBox(prompt[, buttons][, title][, helpfile, context])
prompt
作為消息顯示在對(duì)話框中的字符串表達(dá)式。prompt 的最大長(zhǎng)度大約是 1024 個(gè)字符,這取決于所使用的字符的寬度。如果 prompt 中包含多個(gè)行,則可在各行之間用回車(chē)符 (Chr(13))、換行符 (Chr(10)) 或回車(chē)換行符的組合 (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)上不可用。
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ū)別開(kāi)來(lái)。
下面的例子演示了 MsgBox 函數(shù)的用法:
Dim MyVar MyVar = MsgBox ("Hello World!", 65, "MsgBox Example")
' MyVar contains either 1 or 2, depending on which button is clicked.