Applies ToAccess for Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

在 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

Need more help?

Want more options?

探索訂閱權益、瀏覽訓練課程、瞭解如何保護您的裝置等等。

社群可協助您詢問並回答問題、提供意見反應,以及聆聽來自具有豐富知識的專家意見。