在 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