|
Microsoft® Visual Basic® Scripting Edition MsgBox 函數(shù) |
語言參考 版本 1 |
在對話框中顯示消息，等待用戶單擊按鈕，并返回一個值指示用戶單擊的按鈕。
MsgBox(prompt[, buttons][, title][, helpfile, context])MsgBox 函數(shù)的語法有以下參數(shù)：
參數(shù) 描述 prompt 作為消息顯示在對話框中的字符串表達式。prompt 的最大長度大約是 1024 個字符，這取決于所使用的字符的寬度。如果 prompt 中包含多個行，則可在各行之間用回車符 (Chr(13))、換行符 (Chr(10)) 或回車換行符的組合 (Chr(13) & Chr(10)) 分隔各行。 buttons 數(shù)值表達式，是表示指定顯示按鈕的數(shù)目和類型、使用的圖標樣式，默認按鈕的標識以及消息框樣式的數(shù)值的總和。有關數(shù)值，請參閱“設置”部分。如果省略，則 buttons 的默認值為 0。 title 顯示在對話框標題欄中的字符串表達式。如果省略 title，則將應用程序的名稱顯示在標題欄中。 helpfile 字符串表達式，用于標識為對話框提供上下文相關幫助的幫助文件。如果已提供 helpfile，則必須提供 context。在 16 位系統(tǒng)平臺上不可用。 context 數(shù)值表達式，用于標識由幫助文件的作者指定給某個幫助主題的上下文編號。如果已提供 context，則必須提供 helpfile。在 16 位系統(tǒng)平臺上不可用。
buttons 參數(shù)可以有以下值：
常數(shù) 值 描述 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 應用程序模式：用戶必須響應消息框才能繼續(xù)在當前應用程序中工作。 vbSystemModal 4096 系統(tǒng)模式：在用戶響應消息框前，所有應用程序都被掛起。 第一組值 (0 - 5) 用于描述對話框中顯示的按鈕類型與數(shù)目；第二組值 (16, 32, 48, 64) 用于描述圖標的樣式；第三組值 (0, 256, 512) 用于確定默認按鈕；而第四組值 (0, 4096) 則決定消息框的樣式。在將這些數(shù)字相加以生成 buttons 參數(shù)值時，只能從每組值中取用一個數(shù)字。
MsgBox 函數(shù)有以下返回值：
常數(shù) 值 按鈕 vbOK 1 確定 vbCancel 2 取消 vbAbort 3 放棄 vbRetry 4 重試 vbIgnore 5 忽略 vbYes 6 是 vbNo 7 否
如果同時提供了 helpfile 和 context，則用戶可以按 F1 鍵以查看與上下文相對應的幫助主題。如果對話框顯示取消按鈕，則按 ESC 鍵與單擊取消的效果相同。如果對話框包含幫助按鈕，則有為對話框提供的上下文相關幫助。但是在單擊其他按鈕之前，不會返回任何值。