メッセージボックス関数
解説
ダイアログ ボックスにメッセージを表示し、ユーザーがボタンをクリックするのを待ち、ユーザーがクリックしたボタンを示す整数型を返します。
構文
MsgBox ( prompt [, buttons ] [, title ] [, helpfile ] [, context ] )
引数の説明
MsgBox 関数の構文には、次の引数があります。通常に使用するものは上の3段「Prompt」表示文、「Buttons」ボタンの種類、「Title」ボタンのタイトルでしょう。
| 引数 | 説明 |
|---|---|
| Prompt | Prompt 必ず指定します。 ダイアログ ボックスにメッセージとして表示される文字列式。 プロンプトの最大長は、使用される文字の幅に応じて約 1024 文字です。 |
| Buttons | 省略可能。 表示するボタンの数と種類、使用するアイコンのスタイル、 既定のボタンの ID、およびメッセージ ボックスのモーダル表示を指定する値の合計である数値式。 省略すると、buttons の既定値は 0 です。 |
| Title | 省略可能。 ダイアログ ボックスのタイトル バーに表示する文字列式を指定します。 引数 title を省略すると、タイトル バーにはアプリケーション名が表示されます。 |
| Helpfile | 省略可能。 ダイアログ ボックスに状況依存のヘルプを設定するために、使用するヘルプ ファイルを識別する文字列式を指定します。 引数 helpfile を指定した場合は、引数 context も指定する必要があります。 |
| Context | 省略可能。 ヘルプ作成者が該当するヘルプ トピックに割り当てたヘルプ コンテキスト番号を表す数式を指定します。 引数 context を指定した場合は、引数 helpfile も指定する必要があります。 |
buttons 引数設定
ボタンは名前（定数）または値（数値）のどちらでも指定できます。
| 定数 | 値 | 説明 |
|---|---|---|
| vbOKOnly | 0 | [OK] ボタンのみを表示します。 |
| vbOKCancel | 1 | [OK] ボタンと [キャンセル] ボタンを表示します。 |
| vbAbortRetryIgnore | 2 | [中止] ボタン、[再試行] ボタン、[無視] ボタンを表示します。 |
| vbYesNoCancel | 3 | [はい] ボタン、[いいえ] ボタン、[キャンセル] ボタンを表示します。 |
| vbYesNo | 4 | [はい] ボタンと [いいえ] ボタンを表示します。 |
| vbRetryCancel | 5 | [再試行] ボタンと [キャンセル] ボタンを表示します。 |
| vbCritical | 16 | 重要メッセージ アイコンを表示します。 |
| vbQuestion | 32 | 警告クエリ アイコンを表示します。 |
| vbExclamation | 48 | 警告メッセージ アイコンを表示します。 |
| vbInformation | 64 | 情報メッセージ アイコンを表示します。 |
| vbDefaultButton1 | 0 | 最初のボタンが既定です。 |
| vbDefaultButton2 | 256 | 2 番目のが既定です。 |
| vbDefaultButton3 | 512 | 3 番目のボタンが既定です。 |
| vbDefaultButton4 | 768 | 4 番目のボタンが既定です。 |
| vbApplicationModal | 0 | アプリケーション モーダル。ユーザーが現在のアプリケーションで作業を継続するには、メッセージ ボックスに応答する必要があります。 |
| vbSystemModal | 4096 | システム モーダル。ユーザーがメッセージ ボックスに応答するまで、すべてのアプリケーションは停止されます。 |
| vbMsgBoxHelpButton | 16384 | メッセージ ボックスに [ヘルプ] ボタンを追加します |
| VbMsgBoxSetForeground | 65536 | フォアグラウンド ウィンドウとしてメッセージ ボックス ウィンドウを指定します |
| vbMsgBoxRight | 524288 | テキストは右揃えです |
| vbMsgBoxRtlReading | 1048576 | ヘブライ語やアラビア語のシステムでは、右から左の方向に読み取られるため、それに合わせてテキストを表示するように指定します |
値の最初のグループ (0 から 5) では、ダイアログ ボックスに表示されるボタンの数と種類について説明します。 2 番目のグループ (16、32、48、64) はアイコン のスタイルを記述します。3 番目のグループ (0、256、512) は、 既定のボタンを決定します。4 番目のグループ (0, 4096) は、メッセージ ボックスのモダリティを決定します。 数値を追加して buttons 引数の最終的な値を作成する場合は、各グループから 1 つの数値のみを使用します。
戻り値
メッセージのボタンをクリックしたときの戻り値です。定数または値により処理を分岐する時に使います。
| 定数 | 値 | 説明 |
|---|---|---|
| vbOK | 1 | OK |
| vbCancel | 2 | キャンセル |
| vbAbort | 3 | 中止 |
| vbRetry | 4 | 再試行 |
| vbIgnore | 5 | 無視 |
| vbYes | 6 | はい |
| vbNo | 7 | いいえ |
（この項終わり）