テキスト入力を求めるウィンドウを表示する
InputBox, OutputVar [, Title, Prompt, HIDE, Width, Height, X, Y, Font, Timeout, Default]
| 引数名 | 説明 |
|---|---|
| OutputVar | 入力されたテキストを格納する変数名 |
| Title | ウィンドウのタイトル。省略時はスクリプト名。 |
| Prompt | ウィンドウに表示されるメッセージ。省略時は何も表示されない。 |
| HIDE | 「HIDE」と指定すると、パスワード入力欄のように入力された文字が「*」になる。 |
| Width | ウィンドウの幅をピクセル数で指定。省略時は375。最低でも130くらい無いと、ボタンが表示しきれない。なお、ウィンドウはリサイズ可能。 |
| Height | ウィンドウの高さをピクセル数で指定。省略時は189。110程度無いと、Promptが隠れてしまう。 |
| X, Y | ウィンドウの表示される座標。それぞれ省略時は、スクリーンの中心になる。 |
| Font | 未実装。 |
| Timeout | 入力の時間制限を秒数で指定。最大は「2147483」(24.8日)で、これを超えた場合はこの値になる。この時間を越えると、ウィンドウは閉じられ、ErrorLevelが「2」になる。OutputVarには、その時点でユーザーが入力していた文字列が格納される。 |
| Default | ウィンドウ表示時に入力欄に入っている内容。 |
テキスト入力欄と「OK」「Cancel」ボタンの付いたウィンドウが表示される。
入力欄にフォーカスがあるときにEnterキーを押した場合、「OK」ボタンを押したのと同じ扱いになる。
ウィンドウの「閉じる」ボタンなどを押してウィンドウを閉じた場合は、「Cancel」ボタンを押したのと同じ扱いになる。
「Cancel」ボタンが押されたり、Timeoutの時間が経過した場合でも、OutputVarにはその時点で入力欄に入力されていた内容が格納される。
入力を待っている間、現在のスレッドは停止する。
入力を待っている間は、他のスレッドが割り込むことが可能。
割り込んだスレッドがもう一つInputBoxのウィンドウを表示することも可能。
Gui,+OwnDialogsを使用することで、GUIウィンドウの子ウィンドウとしてダイアログを表示することができる。
子ウィンドウとしてダイアログが表示されている間は、親となるGUIウィンドウは操作できなくなる。
Input, MsgBox, FileSelectFile, FileSelectFolder, SplashTextOn, ToolTip
InputBox, password, Enter Password, (your input will be hidden), hide InputBox, UserInput, Phone Number, Please enter a phone number., , 640, 480 if ErrorLevel <> 0 MsgBox, CANCEL was pressed. else MsgBox, You entered "%UserInput%"