Interaction.MsgBox 方法

發行項
08/20/2007

在對話方塊中顯示訊息、等候使用者按一下按鈕，然後傳回表示使用者按下的按鈕之整數。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function MsgBox ( _
    Prompt As Object, _
    <OptionalAttribute> Optional Buttons As MsgBoxStyle = MsgBoxStyle.OkOnly, _
    <OptionalAttribute> Optional Title As Object = Nothing _
) As MsgBoxResult
'用途
Dim Prompt As Object
Dim Buttons As MsgBoxStyle
Dim Title As Object
Dim returnValue As MsgBoxResult

returnValue = Interaction.MsgBox(Prompt, Buttons, Title)

public static MsgBoxResult MsgBox (
    Object Prompt,
    [OptionalAttribute] MsgBoxStyle Buttons,
    [OptionalAttribute] Object Title
)

public:
static MsgBoxResult MsgBox (
    Object^ Prompt, 
    [OptionalAttribute] MsgBoxStyle Buttons, 
    [OptionalAttribute] Object^ Title
)

public static MsgBoxResult MsgBox (
    Object Prompt, 
    /** @attribute OptionalAttribute() */ MsgBoxStyle Buttons, 
    /** @attribute OptionalAttribute() */ Object Title
)

public static function MsgBox (
    Prompt : Object, 
    Buttons : MsgBoxStyle, 
    Title : Object
) : MsgBoxResult

參數

Prompt
必要項。String 運算式，顯示為對話方塊中的訊息。Prompt 長度的最大值大約為 1024 個字元，需視使用的字元寬度而定。如果 Prompt 是由一行以上所組成，您可以在每一行之間使用歸位字元 (Carriage Return) (Chr(13))、換行字元 (Chr(10)) 或是歸位字元和換行字元的組合 (Chr(13) & Chr(10)) 來分隔行。

Buttons
選擇項。數值運算式，其為指定要顯示的按鈕數目和類型、要使用的圖示樣式、預設按鈕的識別以及訊息方塊是否為強制回應等值的總和。如果您省略 Buttons，預設值會是零。

Title
選擇項。String 運算式，會顯示在對話方塊的標題列中。如果您省略 Title，則會將應用程式名稱置於標題列中。

傳回值

常數 OK, 值 1。常數 Cancel, 值 2。常數 Abort, 值 3。常數 Retry, 值 4。常數 Ignore, 值 5。常數 Yes, 值 6。常數 No, 值 7。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 MsgBox 函式 (Visual Basic)。

如果對話方塊顯示 [取消] 按鈕，則按下 ESC 鍵與按下 [取消] 的作用相同。如果此對話方塊包含 [說明] 按鈕，則會提供此對話方塊的即時線上說明。但是，要等到按下其中一個其他按鈕之後，才會傳回值。

注意事項
若要指定第一個引數之外的引數，則必須在運算式中使用 MsgBox 函式。如果您省略任何位置引數，則必須保留對應的逗號分隔符號。

注意事項
MsgBox 函式在 SafeTopLevelWindows 層級需要 UIPermission，這可能會在部分信任的情況下影響其執行。如需詳細資訊，請參閱要求使用權限和 UIPermission。

MsgBoxStyle 列舉值會列在下表中。

成員	值	描述
OKOnly	0	僅顯示 [確定] 按鈕。
OKCancel	1	顯示 [確定] 和 [取消] 按鈕。
AbortRetryIgnore	2	顯示 [中止]、[重試] 和 [忽略] 按鈕。
YesNoCancel	3	顯示 [是]、[否] 和 [取消] 按鈕。
YesNo	4	顯示 [是] 和 [否] 按鈕。
RetryCancel	5	顯示 [重試] 和 [取消] 按鈕。
Critical	16	顯示 [重大訊息] 圖示。
Question	32	顯示 [警告查詢] 圖示。
Exclamation	48	顯示 [警告訊息] 圖示。
Information	64	顯示 [資訊訊息] 圖示。
DefaultButton1	0	第一個按鈕為預設值。
DefaultButton2	256	第二個按鈕為預設值。
DefaultButton3	512	第三個按鈕為預設值。
ApplicationModal	0	應用程式為強制回應。使用者必須先回應訊息方塊之後，才能繼續進行目前應用程式中的工作。
SystemModal	4096	系統是強制回應的。所有的應用程式都會暫止，直到使用者對訊息方塊做出回應時為止。
MsgBoxSetForeground	65536	將訊息方塊視窗指定為前景視窗。
MsgBoxRight	524288	文字靠右對齊。
MsgBoxRtlReading	1048576	指定在希伯來文或阿拉伯文的系統上，文字應該以從右到左的書寫方式呈現。

第一組的值 (0–5) 描述顯示在對話方塊中的按鈕數目和類型。第二組的值 (16、32、48、64) 則描述圖示樣式。第三組的值 (0、256、512) 可決定哪一個按鈕為預設值。第四組的值 (0、4096) 可決定訊息方塊是否為強制回應，而第五組的值則指定訊息方塊視窗是否為前景視窗 (連同文字的對齊方式和方向)。當加入數字來建立 Buttons 引數的最後一個值時，只能使用每一組中的一個數字。

範例

此範例使用 MsgBox 函式在具有 [是] 和 [否] 按鈕的對話方塊中顯示嚴重錯誤訊息。[否] 按鈕指定為預設回應。這是藉由將 MsgBox 常數值結合到一個數值運算式中來完成這樣的處理。在此例中，將 4 ([是] / [否] 按鈕的組合) 和 16 ([重大訊息] 視窗) 以及 256 (第二個按鈕當做預設按鈕) 相加會產生 276 的總和。MsgBox 函式傳回的值需視使用者所選的按鈕而定：[是] 會傳回 6 的值，而 [否] 則會傳回 7 的值。

Dim msg As String
Dim title As String
Dim style As MsgBoxStyle
Dim response As MsgBoxResult
msg = "Do you want to continue?"   ' Define message.
style = MsgBoxStyle.DefaultButton2 Or _
   MsgBoxStyle.Critical Or MsgBoxStyle.YesNo
title = "MsgBox Demonstration"   ' Define title.
' Display message.
response = MsgBox(msg, style, title)
If response = MsgBoxResult.Yes Then   ' User chose Yes.
   ' Perform some action.
Else
   ' Perform some other action.
End If

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

共用方式為

Interaction.MsgBox 方法

語法

參數

傳回值

備註

範例

平台

版本資訊

.NET Framework

.NET Compact Framework

請參閱

參考

其他資源

其他資源