Excel VBA MsgBox関数

MsgBox【ﾒｯｾｰｼﾞﾎﾞｯｸｽ】関数

MsgBox【ﾒｯｾｰｼﾞﾎﾞｯｸｽ】関数は、警告や注意などのアイコン「はい」や「OK」ボタンなどを表示したメッセージを表示します。

クリックしたボタンによって一定の戻り値が返るため、戻り値を使って条件分岐をして処理を振り分けることができます。

MsgBox【ﾒｯｾｰｼﾞﾎﾞｯｸｽ】関数の書式と設定値(引数)の説明

[]内は省略可能です。
MsgBox( Prompt[, Buttons, Title, Helpfile, Context ])

Prompt【ﾌﾟﾛﾝﾌﾟﾄ】（必須）
ダイアログボックスに表示するメッセージとなる文字列を指定します。
Buttons【ﾎﾞﾀﾝｽﾞ】（省略可）
定数を使用して「ボタンの種類」「アイコンの種類」「メッセージボックスの状態」などを指定します。
複数の定数を指定する場合は算術演算子のプラス「+」を使用して定数を加算（つなげる）します。定数の値を使用する場合は値の加算値（合計値）を使用します。
「引数Buttonsで設定できる定数一覧表」
Title【ﾀｲﾄﾙ】（省略可）
タイトルバーに表示する文字列を指定します。
Helpfile【ﾍﾙﾌﾟﾌｧｲﾙ】（省略可）
ヘルプファイルを指定します。
ヘルプファイルは、メッセージボックスに表示された「ヘルプ」ボタンがクリックされたときに表示するヘルプファイルの名前で、ヘルプファイルのパス（場所）を指定します。
Context【ｺﾝﾃｷｽﾄ】（省略可）
表示するヘルプの内容に対応したコンテキスト番号を指定します。コンテキスト番号とは、ヘルプファイルを開くときに表示する番号で、表示するヘルプの内容に対応した番号を指定します。

MsgBox関数の戻り値

MsgBox関数でボタンによる戻り値を取得する場合例えば、複数のボタンを配置しクリックしたボタンの戻り値により処理を振り分ける場合は、引数を「()」カッコで囲みます。クリックしたボタンに応じて整数型(Integer)の定数の戻り値が返されるので、戻り値は整数(Integer)の変数を使用して格納します。

ボタンによる戻り値を利用しない場合、例えば、メッセージを表示して「OK」ボタンだけ表示する場合は戻り値を利用しないので引数は「()」カッコで囲みません。

ボタンの戻り値一覧

定数	値	クリックされたボタン
vbOK	1	[OK]ボタン
vbCancel	2	[キャンセル]ボタン
vbAbort	3	[中止]ボタン
vbRetry	4	[再試行]ボタン
vblgnore	5	[無視]ボタン
vbYes	6	[はい]ボタン
vbNo	7	[いいえ]ボタン

メッセージ文を複数行にして表示するには

メッセージボックスのテキストを複数行に分けて表示するには、ASCII(ｱｽｷｰ)コード対応する文字を取得するChr【ｷｬﾗｸﾀｰ】関数を使用して、改行文字を表す「Chr(10)&Chr(13)」または
組み込み定数の「vbCrLf」を改行したい位置に挿入します。

改行コード例

Sub 改行()
 MsgBox "現在日時" & Chr(10) & Chr(13) & Now
End Sub

Sub 改行2()
 MsgBox "現在日時" & vbCrLf & Now
End Sub

実行結果

引数Buttons【ﾎﾞﾀﾝｽﾞ】で設定できる定数一覧表

ボタンの種類を指定する定数一覧表

定数	値	内容
vbOKOnly	0	[OK]ボタンを表示します。
vbOKCancel	1	[OK]と[キャンセル]ボタンを表示します。
vbAbortRetryIgnore	2	[OK]、[キャンセル]、[無視]ボタンを表示します。
vbYesNoCancel	3	[はい]、[いいえ]、[キャンセル]ボタンを表示します。
vbYesNo	4	[はい]と[いいえ]ボタンを表示します。
vbRetryCancel	5	[再試行]と[キャンセル]ボタンを表示します。

アイコンの種類を指定する定数一覧表

定数	値	内容
vbCritical	16	「警告アイコン」を表示します。
vbQuestion	32	「問い合わせアイコン」を表示します。
vbExclamation	48	「注意アイコン」を表示します。
vbInformation	64	「情報アイコン」を表示します。

標準ボタンを指定する定数一覧表

標準ボタンとは、メッセージボックス表示時に最初から選択状態になっているボタンのことです。[Enter]キーでクリックしたときと同じ動作ができます。

定数	値	内容
vbDefaultButton1	0	第1ボタンを既定で選択されているボタンにします。
vbDefaultButton2	256	第2ボタンを既定で選択されているボタンにします。
vbDefaultButton3	512	第3ボタンを既定で選択されているボタンにします。
vbDefaultButton4	768	第4ボタンを既定で選択されているボタンにします。

メッセージボックスの状態指定する定数一覧表

定数	値	内容
vbApplicationModal	0	メッセージボックスに応対するまで Excelの他の操作はできません。
vbSystemModal	4096	メッセジボックスに応対するまですべてのアプリケーションの操作はできません。

その他の定数一覧表

定数	値	内容
vbMsgBoxHelpButton	16384	ヘルプボタンを追加します。
vbMsgBoxSetForeground	65536	最前面のウィンドウとして表示します。
vbMsgBoxRight	524288	テキストを右寄せで表示します。。
vbMsgBoxRtlReading	1048576	テキストを右から左の方向で表示します。

以上で、MsgBox【ﾒｯｾｰｼﾞﾎﾞｯｸｽ】関数についての解説を終了します。ありがとうございました。