メッセージダイアログを表示する。色々なボタンを表示したり、タイムアウトを指定することも可能。
MsgBox, Text MsgBox [, Options, Title, Text, Timeout]
| 引数名 | 説明 |
|---|---|
| Text |
ダイアログに表示するメッセージ。 「`n」で改行を含む内容も表示できる。 全ての引数が省略された場合、「Press OK to continue.」というメッセージが表示される。 引数がTextだけの形式の場合、カンマをエスケープする必要はない。 |
| Options |
表示するボタンや、その他の設定を指定する。 詳細はRemarks参照。 省略時は「0」。 |
| Title | ダイアログのタイトル。 省略時はスクリプト名。 |
| Timeout | 応答の時間制限を秒数で指定。最大は「2147483」(24.8日)で、これを超えた場合はこの値になる。 この時間を経過すると、ウィンドウは自動的に閉じる。 |
Options引数で、表示するボタン、アイコン、最初にフォーカスのあるボタン、最前面かどうかを設定できる。
下記の数の和を指定する。
| ボタン | 値 |
|---|---|
| 「OK」 | 0 |
| 「OK」「キャンセル」 | 1 |
| 「中止」「再試行」「無視」 | 2 |
| 「はい」「いいえ」「キャンセル」 | 3 |
| 「はい」「いいえ」 | 4 |
| 「再試行」「キャンセル」 | 5 |
| 「キャンセル」「再試行」「続行」 | 6 |
| アイコン | 値 |
|---|---|
| 「×」 | 16 |
| 「?」 | 32 |
| 「!」 | 48 |
| 「i」 | 64 |
| ボタン | 値 |
|---|---|
| 2番目のボタン | 256 |
| 3番目のボタン | 512 |
| 設定 | 値 |
|---|---|
| 最前面 | 4096 |
| 他のウィンドウを停止して最前面(無効の場合あり) | 8192 |
IfMsgBoxコマンドで、どのボタンが押されたかや、制限時間が経過したかを判別することができる。
Gui,+OwnDialogsを使用することで、GUIウィンドウの子ウィンドウとしてダイアログを表示することができる。
子ウィンドウとしてダイアログが表示されている間は、親となるGUIウィンドウは操作できなくなる。
Optionsに「16384」を足すと、「ヘルプ」ボタンが追加される。
Gui,+OwnDialogsを使用している場合、ヘルプボタンが押されるとGuiウィンドウにWM_HELP(0x53)メッセージが送られる。OnMessage()関数でメッセージ処理関数を割り当てておくことで、ヘルプボタン押し下げに応答できる。
IfMsgBox, InputBox, FileSelectFile, FileSelectFolder, ToolTip
MsgBox, This is the 1-param method. Commas, do, not, need to be escaped. MsgBox, 4, , This is the 3-param method, non-escaped commas ok.`n`nContinue? IfMsgBox, No return MsgBox, 4, , This MsgBox will time out in 5 seconds. Continue?, 5 IfMsgBox, Timeout MsgBox, The previous MsgBox timed out. else IfMsgBox, No return