Interaction.MsgBox メソッド

.NET Framework クラス ライブラリ リファレンス

Interaction.MsgBox メソッド

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

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function MsgBox
 ( _
    Prompt As Object, _
    <OptionalAttribute> Optional Buttons As
 MsgBoxStyle = MsgBoxStyle.OkOnly, _
    <OptionalAttribute> Optional Title As
 Object = Nothing _
) As MsgBoxResult

Visual Basic (使用法)

Dim Prompt As Object
Dim Buttons As MsgBoxStyle
Dim Title As Object
Dim returnValue As MsgBoxResult

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

C#

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

C++

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

J#

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

JScript

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

パラメータ

Prompt

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

Buttons

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

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	[OK] ボタンのみを表示します。
OKCancel	1	[OK] ボタンと [キャンセル] ボタンを表示します。
AbortRetryIgnore	2	[中止]、[再試行]、および [無視] の 3 つのボタンを表示します。
YesNoCancel	3	[はい]、[いいえ]、および [キャンセル] の 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 つの値だけを使用してください。

使用例

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

Visual Basic

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Interaction クラス
Interaction メンバ
Microsoft.VisualBasic 名前空間
その他の技術情報
MsgBox 関数 (Visual Basic)
InputBox 関数 (Visual Basic)