GuiControlGet

提供: AutoHotkey Wiki
移動: 案内検索

実行制御 | GUI表示 | 演算・変数 | メモリ・DLL操作 | 文字列操作 | キーボード | マウス | シェル | ウィンドウ | ウィンドウグループ
ステータスバー | コントロール | サウンド | ファイル | INIファイル | レジストリ | 環境変数 | AutoHotkey | その他 | 設定関係 | オブジェクト

GuiControlGet[編集]

Guiコマンドで作成したウィンドウに配置されたコントロールの各種情報を取得する。

GuiControlGet, OutputVar [, SubCommand, ControlID, Param4]

Parameters[編集]

引数名 説明
OutputVar 取得した結果を格納する変数名
SubCommand 取得する情報の種類を指定する。
省略時は、コントロールの内容を取得する。
ControlID 対象となるコントロールを指定する。
コントロール作成時に vオプションで変数を割り当てている場合、その変数名で指定できる。
それ以外の場合、コントロールのClassNNかコントロールに含まれるテキストを指定する。
Pictureコントロールの画像ファイル名も指定できる。
省略時は、OutputVarで指定した変数が vオプションで関連付けられたコントロールになる。

[v1.1.04+]: ControlID can be the HWND of a control. As with any other value for ControlID, the Gui must also be specified if the control is not on the default Gui.

Param4 各SubCommandの説明参照。特に説明がなければ、省略する。

ErrorLevel[編集]

何か問題があれば 1、正常に終了すれば 0

AHKL [v1.1.04+] このコマンドは失敗した場合に例外をスローすることができる。詳細は実行時エラーを参照。

SubCommand省略時[編集]

以下の種類のコントロール以外では、Gui,Add時にText引数で設定される部分の内容が取得される。

Hotkey ホットキーが入力されていれば、 ^!C ^Home ^NumpadHomeのような形式(ホットキーラベルでそのまま使用できる)で取得される。
Slider
Progress
現在の位置が取得される。
Picture コントロールがGui,Addで追加されたときに読み込まれた画像のファイル名が取得される。
Checkbox
Radio
0ならチェックなし、 1ならチェックあり、 -1なら半チェック。
Param4に Textを指定すると、代わりにコントロールのキャプションが取得される。
DropDownList
ComboBox
ListBox
Tab
選択されている項目のテキストが取得される。
ComboBoxでは、入力欄に入力されているテキストが取得される。
ActiveX コントロールのActiveXコンポーネントのための新しいラッパーオブジェクトを取得する。

SubCommand[編集]

Pos コントロールの座標と高さを取得する。
このサブコマンドでは、OutputVarで指定した名前に X Y W Hをつけた名前の変数に、それぞれX座標/Y座標/幅/高さが格納される。
座標は、ウィンドウのタイトルバーやメニューバーをのぞいたクライアントエリア上での座標で取得される。
Enabled ウィンドウが有効状態なら 1、無効化されていれば 0
Visible コントロールが表示されていれば 1、非表示になっていれば 0
Focus ウィンドウ上の入力フォーカスを持っているコントロールのClassNNを取得する。
このサブコマンドでは、ControlIDは指定しない。
ウィンドウがアクティブでない場合、入力フォーカスを持つコントロールはないので、OutputVarは空になる。
FocusV Focusと同じだが、ClassNNの代わりにコントロールに割り当てた変数名を取得する。
変数が割り当てられていない場合、代わりにコントロールのテキストの最初の63文字までが取得される。
Hwnd DllCallPostMessage/SendMessageなどで使用するウィンドウハンドルを得る。
Name Retrieves the name of the control's associated variable if it has one, otherwise OutputVar is made blank.

Remarks[編集]

スクリプトは最大で10のウィンドウを持つことが出来る。
デフォルト以外のウィンドウを操作するには、サブコマンドの前に 2:のようにウィンドウ番号とコロンを追加する。

基本的にデフォルトのウィンドウ番号は 1だが、2番目以降のウィンドウ上のGUI操作の結果実行されたスレッドでは、そのウィンドウの番号がデフォルトになる。

GuiControlGet, MyEdit, 2:
GuiControlGet, Outputvar, 2:Focus
GuiControlGet, OutputVar, 2:Pos, MyEdit

Related[編集]

GUI, GuiControl, ControlGet

Example(s)[編集]

GuiControlGet, MyEdit
GuiControlGet, CtrlContents,, MyEdit	; Same as the above except uses a non-default output variable.
GuiControlGet, MyCheckbox1		; Retrieves 1 if it is checked, 0 if it is unchecked.
GuiControlGet, MyCheckbox1,,, Text	; Retrieves the caption/text of the checkbox. 
GuiControlGet, Pic, Pos, Static4	; The position/size will be stored in PicX, PicY, PicW, and PicH