在 Access 桌面資料庫中，MsgBox 函數會在對話框中顯示訊息、等候使用者按兩下按鈕，並傳 回一個 整數，指出使用者已按下哪個按鈕。
語法
MsgBox ( 提示 [， buttons ] [， title ] [， helpfile ] [， context ] )
MsgBox 函數語法具有下列自變數：
|
引數 |
描述 |
|---|---|
|
提示 |
必要。 字串表示式在對話框中顯示為訊息。 提示 字元的 長度上限大約為 1024 個字元，視所使用的字元寬度而定。 如果提示包含多行， 您可以使用歸位字元 (Chr (13 ) ) 、 ( 10 ) ) Chr (線段字元或歸位字元 - 線條字元組合 (Chr ( 13) & Chr (每行之間 (10) ) ，來分隔線條。 |
|
按鈕 |
選擇性。 數值運算式 這是指定要顯示之按鈕數目與類型的數值總和、要使用的圖示樣式、默認按鈕的身分識別，以及消息框的形式。 如果省略， 按鈕 的預設值為 0。 |
|
標題 |
選擇性。 對話框標題列中顯示的字串表達式。 如果您省略 標題，應用程式名稱會放在標題欄中。 |
|
helpfile |
選擇性。 字串表示式，用來為對話方塊提供內容相關說明的 [說明]。 如果 提供 helpfile ，也必須提供 內容 。 |
|
上下文 |
選擇性。 數值表達式，即說明作者指派給適當説明主題的說明內容編號。 如果提供 內容 ，也必須提供 說明歸檔 。 |
設定
設定引數按鈕 為：
|
常數 |
值 |
描述 |
|---|---|---|
|
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 |
系統模式;所有應用程式都會暫停，直到用戶回應消息框為止。 |
|
vbMsgBoxHelpButton |
16384 |
在消息框中新增 [說明] 按鈕 |
|
VbMsgBoxSetForeground |
65536 |
指定消息框視窗做為前景視窗 |
|
vbMsgBoxRight |
524288 |
文字靠右對齊 |
|
vbMsgBoxRtlReading |
1048576 |
指定文字在希伯來文和阿拉伯文系統上應顯示為從右至左閱讀 |
第一組值 (0 到 5) 描述對話框中顯示的按鈕數目和類型;第二個群組 (16、32、48、64) 描述圖示樣式;第三個群組 (0、256、512) 決定哪個按鈕為預設值;而第四個群組 (0、4096) 決定消息框的模式。 加總數位以建立 按鈕 自變數的最終值時，每個群組只使用一個數位。
附註: 這些常數是由 Visual Basic for Applications 指定。 因此，您可以在代碼中的任何位置使用名稱來取代實際的值。
傳回值
|
常數 |
值 |
描述 |
|---|---|---|
|
vbOK |
1 |
確定 |
|
vbCancel |
2 |
取消 |
|
vbAbort |
3 |
中止 |
|
vbRetry |
4 |
重試 |
|
vbIgnore |
5 |
略過 |
|
vbYes |
6 |
是 |
|
vbNo |
7 |
否 |
註解
同時提供 說明歸檔 和 內容 時，使用者可以按下 F1 (Windows) 或 help (macOS) 來檢視與 內容對應的幫助主題。 有些主機應用程式，例如 Microsoft Excel，也會自動在對話框中新增 [說明] 按鈕。
如果對話框顯示 [ 取消 ] 按鈕，按 ESC 鍵的效果會與按下 [ 取消] 相同。 如果對話框包含 [ 說明 ] 按鈕，對話框會提供與內容相關聯的 [說明]。 不過，在單擊其他其中一個按鈕之前，不會傳回任何值。
附註: 若要指定超過第一個具名自變數，您必須在 運算式中使用 MsgBox 。 若要省略某些位置自變數，您必須包含對應的逗號分隔符。
範例
附註: 下列範例示範如何在 Visual Basic for Applications (VBA) 模組中使用此函數。
此範例使用 MsgBox 函數在含有 [是] 和 [否] 按鈕的對話框中顯示重大錯誤訊息。 系統會將 [否] 按鈕指定為預設回應。 MsgBox 函數傳回的值取決於使用者選擇的按鈕。 此範例假設 DEMO.HLP 是說明檔案，其中包含的幫助內容編號等於 1000的主題。
Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If
