Function Reference

MsgBox

オプションによってタイムアウト時間を設定したシンプルなメッセージボックスを表示します。

MsgBox ( flag, "title", "text" [, timeout [, hwnd]] )

 

パラメータ

flag メッセージボックスの種類と表示するボタンの組み合わせを指定します。”注意”を参照。
title メッセージボックスの名前
text メッセージボックスのテキスト
timeout [オプション] タイムアウトまでの秒数。タイムアウト時間をすぎるとメッセージボックスは自動的に閉じます。デフォルト値は0で、タイムアウトしません。
hwnd [オプション] このダイアログの親として使用するウィンドウハンドル

 

返し値

成功 押されたボタンのIDを返します。
失敗 タイムアウトした場合-1を返します。


押されたボタン 返し値
OK  1
キャンセル  2
中止  3
再試行  4
無視  5
はい  6
いいえ  7
再実行 ** 10
続行 ** 11

 

注意

フラグパラメータには下表の値の組み合わせて指定することができます。

フラグ(10進数表示) 設定されるボタン フラグ(16進数表示)
0 OK ボタン 0x0
1 OK, キャンセル 0x1
2 中止, 再試行, 無視 0x2
3 はい, いいえ, キャンセル 0x3
4 はい, いいえ 0x4
5 再試行, キャンセル 0x5
6 ** キャンセル, 再実行, 続行 0x6
フラグ(10進数表示) 設定されるアイコン フラグ(16進数表示)
0 (アイコンなし) 0x0
16 ストップサインアイコン 0x10
32 クエスチョンマークアイコン 0x20
48 エクスクラメーションマークアイコン 0x30
64 インフォメーションマークアイコン("i"をまるで囲ったマーク) 0x40
フラグ(10進数表示) 設定されるデフォルト設定 フラグ(16進数表示)
0 最初のボタンがデフォルトボタンになります。 0x0
256 2番目のボタンがデフォルトボタンになります。 0x100
512 3番目のボタンがデフォルトボタンになります。 0x200
フラグ(10進数表示) 設定される形式 フラグ(16進数表示)
0 アプリケーション 0x0
4096 システム形式 (ダイアログはアイコンを持ちます) 0x1000
8192 タスク形式 0x2000
フラグ(10進数表示) その他の設定 フラグ(16進数表示)
0 (通常) 0x0
262144 MsgBox has top-most attribute set 0x40000
524288 タイトルがテキストが右揃えになります。 0x80000

** Windows 2000/XP以上のみ

例えば、「システム形式」で「はい/いいえ」ボタンを持つメッセージボックスを作るためにはフラグは4096+4(あるいは4100)を指定します。もし16進数で設定するのであれば0x1000+0x4 (あるいは0x1004)とします。

メッセージボックスは画面の中央にテキストの長さにあわせて表示されます。ただし、システム形式フラグ(4096)を使用した場合タイトルは切り詰められます。

"title"がDefaultキーワードの場合、@Scriptnameが使用されます。

 

関連

InputBox, ToolTip, TrayTip, SplashTextOn

 


MsgBox(4096, "Test", "This box will time out in 10 seconds", 10)