Gui,Add,UpDown
提供: AutoHotkey Wiki
実行制御 | GUI表示 | 演算・変数 | メモリ・DLL操作 | 文字列操作 |
キーボード | マウス | シェル | ウィンドウ | ウィンドウグループ
ステータスバー | コントロール | サウンド | ファイル | INIファイル |
レジストリ | 環境変数 | AutoHotkey | その他 | 設定関係 | オブジェクト
Gui,Add,UpDown[編集]
GUIウィンドウに数値増減ボタンを追加する。
Gui, Add, UpDown [, Options, DefaultValue]
Parameters[編集]
| 引数名 | 説明 |
|---|---|
| Options | オプションを半角スペース区切りで列挙。 共通のオプションについては、Gui,Addの項参照。 固有のオプションについては後述。 Vで変数名を指定し、Gui,Submit を実行することで、現在の値を取得できる。Editコントロールでユーザーが文字列や範囲外の値など不正な値を入力した場合でも、必ずオプションで設定した範囲内の値が数値として取得される。 Gでサブルーチン名を指定すると、アップダウンボタンの操作や、対象コントロールに対する矢印キーの上下、マウスホイールの回転で値が変更されるごとにサブルーチンが実行される。 |
| DefaultValue | 対象コントロールの値の初期値を数値で指定する。 省略時は 0もしくはRangeオプションで指定された範囲で最も0に近い値になる。対象コントロールに取り付く場合、配置された時点で対象コントロールのテキストにここで指定した値が反映される。 ListBoxに取り付く場合、一番上の項目は 0、次が 1となる。
|
固有のOption[編集]
| Range[Bottom]-[Top] | Bottom に下限、Top に上限を数値で指定する。Range10-100とすると10から100まで、 Range-10--1とすると-10から-1までとなる。Range100-0のようにBottom をTop より大きくした場合、下ボタンや下キーで値が増え、上ボタンや上キーで値が減る。範囲として設定できる値の最大値と最小値は、NT系では2147483647と-2147483648、9x系では、32767と-32767である。 ListBoxに取り付く場合、一番上の項目は 0、次が 1として扱う。なお、下に行くほど値が大きくなるので、 Range4-0のように指定する必要がある。
|
| Wrap | 上限と下限がつながり、上限値を超えて増やそうとすると下限値になり、下限値を超えて減らそうとすると上限値になるようになる。 |
| Left | 対象コントロールの右側ではなく左側に配置される。 |
| Horz | 上下ではなく左右にボタンがついた横型になる。 |
| 16 | 直前に配置したコントロールを対象コントロールにする。 デフォルトでONだが、Horzを指定するとOFFになる。 Horz 16とすれば、横にしつつ対象コントロールに取り付くことができる。(ただし、横幅が狭くなってボタンが押しにくくなる)-16とすると、縦型で対象コントロールのないアップダウンボタンを作成できる。
|
| 32 | 矢印キーの上下で値を増減させられる。 デフォルトでONだが、 -32とすることでOFFにできる。
|
| 128 | 128を指定すると、3桁ごとに ,で区切らなくなる。
|
Remarks[編集]
アップダウンコントロールは通常、直前に配置したコントロールに取り付いてそのコントロールの表示値を増減させる。
対象にできるコントロールは、Text, Edit, Button, Checkbox, Radio, ComboBox, ListBox, GroupBoxである。
ListBoxでは、上下ボタンを押すごとに選択項目が切り替わる。それ以外のコントロールでは、アップダウンコントロールが持つ数値が増減し、対象コントロールのテキストに反映される。
対象コントロールに取り付く場合、w,h,x,yの各オプションで大きさや座標を指定することはできない。
ウィンドウに一番最初に配置される場合や、 -16オプションを指定して対象コントロールをなしにした場合、ボタンを押しても見かけ上は変化がないが、格納されている値は変化する。(Gオプションと合わせて使う)
