Interaction.MsgBox(Object, MsgBoxStyle, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ダイアログ ボックスにメッセージを表示し、ユーザーがボタンをクリックするのを待ってから、ユーザーがクリックしたボタンを示す整数を返します。
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複数の行で構成されている場合は、復帰文字 (Chr(13))、改行文字 (Chr(10))、または復帰/改行文字の組み合わせ (Chr(13) & Chr(10)) を使用して各行を区切ることができます。
- Buttons
- MsgBoxStyle
このフィールドは省略可能です。 表示するボタンの数と種類、使用するアイコン のスタイル、既定のボタンの ID、メッセージ ボックスのモダリティを指定する値の合計を表す数値式。
Buttonsを省略すると、既定値は 0 になります。
- Title
- Object
このフィールドは省略可能です。
String 式がダイアログ ボックスのタイトル バーに表示されます。
Title省略すると、アプリケーション名がタイトル バーに配置されます。
返品
以下のどちらかの値 :
| 定数 | 価値 |
|---|---|
OK | 1 |
Cancel | 2 |
Abort | 3 |
Retry | 4 |
Ignore | 5 |
Yes | 6 |
No | 7 |
例外
Prompt が String 式ではないか、 Title が無効です。
プロセスがユーザー 対話型モードで実行されていません。
MsgBoxResultまたはMsgBoxStyle列挙体のメンバーではない 1 つ以上のパラメーター。
例
次の使用例は、 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 キーを押すと[キャンセル]をクリックした場合と同じ効果があります。
ダイアログ ボックスに [ヘルプ] ボタンがある場合、ダイアログ ボックスで状況依存ヘルプを使用できます。 ただし、他のボタンのいずれかが選択されるまで、値は返されません。 Windows フォーム アプリケーションで、Help ボタンを選択すると、フォームの HelpRequested イベントが実行されます。
Note
MsgBox関数では、UIPermission レベルでSafeTopLevelWindowsが必要です。これは、部分信頼の状況での実行に影響する可能性があります。 詳細については、UIPermissionを参照してください。
MsgBoxStyle列挙値を次の表に示します。
| メンバー | 価値 | Description |
|---|---|---|
| メンバー | 価値 | Description |
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 つの数値のみを使用します。