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のようにBottomTop より大きくした場合、下ボタンや下キーで値が増え、上ボタンや上キーで値が減る。
範囲として設定できる値の最大値と最小値は、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オプションと合わせて使う)

Related[編集]

GUI, Gui,Add, Gui,Add,Edit