請參閱

說明

將訊息顯示在對話方塊中，等使用者按下按鈕，並傳回一值來表示使用者按下的是那一個鈕。

語法

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	「否」

註解

如果同時指定了 helpfile 及 context ，使用者便可以按 F1 來查看與 context 相關的說明主題。

如果對話方塊有顯示 Cancel 按鈕，則按下 ESC 鍵與按下 Cancel. 按鈕效果相同。如果對話方塊中有 Help 按鈕，則對話方塊中提供有文字感應說明。無論如何，在其他按鈕中的一個被按下前，不會傳回任何值。