Interaction.MsgBox(Object, MsgBoxStyle, Object) メソッド

定義

ダイアログ ボックスにメッセージを表示し、ユーザーがボタンをクリックするのを待った後、ユーザーのクリックしたボタンを示す整数値を返します。

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, object? Title = default);
public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = default);
static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, Optional Title As Object = Nothing) As MsgBoxResult

パラメーター

Prompt
Object

必須です。 ダイアログ ボックスにメッセージとして表示される String 型の式。 Prompt の最大長は、約 1024 文字です。使用される文字の幅によって変わります。 複数の行で構成されている場合Promptは、復帰文字 (13))、改行文字 (Chr(10))、またはキャリッジ リターン/ラインフィード文字Chr(の組み合わせ (Chr(13) & Chr(10)) を使用して各行を区切ることができます。

Buttons
MsgBoxStyle

省略可能。 表示するボタンの種類と数、使用するアイコンのスタイル、既定のボタンの ID、メッセージ ボックスのモーダル性を指定する値の総計を表す数式です。 Buttons を省略した場合、既定値は 0 になります。

Title
Object

省略可能。 ダイアログ ボックスのタイトル バーに表示される String 型の式。 Title を省略した場合、タイトル バーにはアプリケーションの名前が表示されます。

戻り値

次のいずれかの値です。

定数
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

例外

Prompt が文字列型 (String) の式でないか、Title が無効です。

プロセスがユーザー対話モードで動作していません。

MsgBoxResult 列挙型または MsgBoxStyle 列挙型のメンバーでないパラメーターが含まれています。

この例では、 関数を MsgBox 使用して、[はい] ボタンと [いいえ] ボタンを含むダイアログ ボックスに重大エラー メッセージを表示します。 [いいえ] ボタンは、既定の応答として指定されます。 これは、定数値を MsgBox 1 つの数式に組み合わせることによって行われます。 この場合、4 ([はい]/[いいえ] ボタンの組み合わせ) と 16 ( [重大なメッセージ ] ウィンドウ) と 256 (既定のボタンとして 2 番目のボタン) を追加すると、合計 276 が表示されます。 関数によって MsgBox 返される値は、ユーザーが選択したボタンによって異なります。Yes は 6 の値を返します。No は 7 の値を返します。

' The following example requires that Option Infer be set to On.

' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"

' Display a simple message box.
MsgBox(msg)

' Define a title for the message box.
Dim title = "MsgBox Demonstration"

' Add the title to the display.
MsgBox(msg, , title)

' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
            MsgBoxStyle.Critical

' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)

' Take some action based on the response.
If response = MsgBoxResult.Yes Then
    MsgBox("YES, continue!!", , title)
Else
    MsgBox("NO, stop!!", , title)
End If

注釈

位置引数を省略する場合は、対応するコンマ区切り記号を保持する必要があります。

ダイアログ ボックスに [キャンセル ] ボタンが表示される場合、Esc キーを押すと、[キャンセル] をクリックした場合と同じ効果が得 られます

ダイアログ ボックスに [ヘルプ ] ボタンが含まれている場合は、ダイアログ ボックスに状況依存のヘルプが表示されます。 ただし、他のボタンの 1 つが選択されるまで、値は返されません。 Windows フォーム アプリケーションで、[ ヘルプ ] ボタンを選択すると、フォームの HelpRequested イベントが実行されます。

注意

関数は MsgBox レベルで SafeTopLevelWindows を必要UIPermissionとします。これは、部分信頼の状況での実行に影響を与える可能性があります。 詳細については、「UIPermission」を参照してください。

列挙値を MsgBoxStyle 次の表に示します。

メンバー 説明
メンバー 説明
OKOnly 0 [OK] ボタンのみを表示します。
OKCancel 1 [OK] ボタンと [キャンセル] ボタンを表示します。
AbortRetryIgnore 2 [中止]、[再試行]、[無視] の各ボタンを表示します。
YesNoCancel 3 [はい]、[いいえ]、[キャンセル] の各ボタンが表示されます。
YesNo 4 [はい] ボタンと [いいえ] ボタンが表示されます。
RetryCancel 5 [再試行] ボタンと [キャンセル] ボタンを表示します。
Critical 16 クリティカル メッセージ アイコンを表示します。
Question 32 警告クエリ アイコンを表示します。
Exclamation 48 警告メッセージ アイコンを表示します。
Information 64 情報メッセージ アイコンを表示します。
DefaultButton1 0 最初のボタンは既定値です。
DefaultButton2 256 2 番目のボタンは既定値です。
DefaultButton3 512 3 番目のボタンは既定値です。
ApplicationModal 0 アプリケーションはモーダルです。 ユーザーは、現在のアプリケーションで作業を続行する前に、メッセージ ボックスに応答する必要があります。
SystemModal 4096 システムはモーダルです。 すべてのアプリケーションは、ユーザーがメッセージ ボックスに応答するまで中断されます。
MsgBoxSetForeground 65536 メッセージ ボックス ウィンドウを前景ウィンドウとして指定します。
MsgBoxRight 524288 テキストは右揃えです。
MsgBoxRtlReading 1048576 ヘブライ語とアラビア語のシステムでテキストを右から左に読み取るように指定します。

値の最初のグループ (0 から 5) は、ダイアログ ボックスに表示されるボタンの数と種類を表します。 2 番目のグループ (16、32、48、64) は、アイコンのスタイルを記述します。 3 番目のグループ (0、256、512) は、既定のボタンを決定します。 4 番目のグループ (0, 4096) はメッセージ ボックスのモダリティを決定し、5 番目のグループは、メッセージ ボックス ウィンドウが前景ウィンドウであるかどうかを、テキストの配置と方向と共に指定します。 数値を追加して引数の最終的な値を作成する Buttons 場合は、各グループから 1 つの数値のみを使用します。

適用対象

こちらもご覧ください