InputBox
提供: AutoHotkey Wiki
実行制御 | GUI表示 | 演算・変数 | メモリ・DLL操作 | 文字列操作 |
キーボード | マウス | シェル | ウィンドウ | ウィンドウグループ
ステータスバー | コントロール | サウンド | ファイル | INIファイル |
レジストリ | 環境変数 | AutoHotkey | その他 | 設定関係 | オブジェクト
InputBox[編集]
テキスト入力を求めるウィンドウを表示する。
InputBox, OutputVar [, Title, Prompt, HIDE, Width, Height, X, Y, Font, Timeout, Default]
Parameters[編集]
| 引数名 | 説明 |
|---|---|
| OutputVar | 入力されたテキストを格納する変数名 |
| Title | ウィンドウのタイトル。省略時はスクリプト名。 |
| Prompt | ウィンドウに表示されるメッセージ。省略時は何も表示されない。 |
| HIDE | HIDEと指定すると、パスワード入力欄のように入力された文字が *になる。
|
| Width | ウィンドウの幅をピクセル数で指定。省略時は375。最低でも130くらい無いと、ボタンが表示しきれない。なお、ウィンドウはリサイズ可能。 |
| Height | ウィンドウの高さをピクセル数で指定。省略時は189。110程度無いと、Promptが隠れてしまう。 |
| X, Y | ウィンドウの表示される座標。それぞれ省略時は、スクリーンの中心になる。 |
| Font | 未実装。 |
| Timeout | 入力の時間制限を秒数で指定。最大は 2147483(24.8日)で、これを超えた場合はこの値になる。この時間を越えると、ウィンドウは閉じられ、ErrorLevelが 2になる。OutputVarには、その時点でユーザーが入力していた文字列が格納される。 |
| Default | ウィンドウ表示時に入力欄に入っている内容。 |
ErrorLevel[編集]
AHKL [v1.1.04+] このコマンドは失敗した場合に例外をスローすることができる。詳細は実行時エラーを参照。
| 0 | OKボタンが押された
|
| 1 | Cancelボタンが押された
|
| 2 | Timeoutで指定した時間が経過した |
Remarks[編集]
テキスト入力欄と OK Cancelボタンの付いたウィンドウが表示される。
入力欄にフォーカスがあるときにEnterキーを押した場合、 OKボタンを押したのと同じ扱いになる。
ウィンドウの 閉じるボタンなどを押してウィンドウを閉じた場合は、 Cancelボタンを押したのと同じ扱いになる。
Cancelボタンが押されたり、Timeoutの時間が経過した場合でも、OutputVarにはその時点で入力欄に入力されていた内容が格納される。
入力を待っている間、現在のスレッドは停止する。
入力を待っている間は、他のスレッドが割り込むことが可能。
割り込んだスレッドがもう一つInputBoxのウィンドウを表示することも可能。
Gui,+OwnDialogsを使用することで、GUIウィンドウの子ウィンドウとしてダイアログを表示することができる。
子ウィンドウとしてダイアログが表示されている間は、親となるGUIウィンドウは操作できなくなる。
Related[編集]
Input, MsgBox, FileSelectFile, FileSelectFolder, SplashTextOn, ToolTip
Example(s)[編集]
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%"
