ControlGet

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

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

ControlGet[編集]

コントロールの各種状態を取得。

ControlGet, OutputVar, Cmd [, Value, Control, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters[編集]

引数名 説明
OutputVar 結果を格納する変数名。
取得に失敗した場合、空になる。
Cmd 取得したい情報を指定する。
指定できるコマンドは下記参照。
Value コマンドのオプション。下記参照。
Control コントロールを指定。
ウィンドウ指定の方法参照。
WinTitle ウィンドウタイトルなど。
ウィンドウ指定の方法参照。
WinText ウィンドウに含まれるテキスト
ExcludeTitle 除外タイトル
ExcludeText 除外テキスト

Cmd, Value[編集]

Checked チェックボックスやラジオボタンがチェックされているか。
Enabled コントロールが操作可能になっているか。
Visible コントロールが可視になっているか。
Tab タブコントロール(SysTabControl32)の現在のタブ番号。(1...)
FindString, String リストボックスやコンボボックスに指定した文字列の項目があるか(TListBox/TComboBoxコントロールにも対応)
完全に一致するものがあった場合、その番号(1...)が取得される。
見つからなかった場合、OutputVarは空になり、ErrorLevel1になる。
Choice リストボックスやコンボボックスで選択されている項目の番号(TListBox/TComboBoxコントロールにも対応)
List リストボックスやコンボボックス、ドロップダウンリストの項目の一覧(TListBox/TComboBoxコントロールにも対応)
各項目はLF(`n)で区切られる。
List,Options リストビュー(SysListVew32)の情報を取得する。
Optionsを省略した場合、すべての項目のテキストが改行(`n)区切りで取得される。各項目の列はTab文字(`t)で区切られる。
Optionsには以下のものを半角スペース区切りで指定する。
Count 当該項目の数を取得する。
ColN N 番目の列のテキストのみを取得する。(例: Col2)
Selected 選択された項目だけを対象とする。
Focused フォーカスがある項目だけを対象とする。
Count Col 列数を取得する。
LineCount エディットコントロールの現在の行数。
CurrentLine エディットコントロールのキャレットの行位置。(1...)
CurrentCol エディットコントロールのキャレットの桁位置。
Line, N エディットコントロールのN行目の内容。
最後の改行コードを含む。
N の値が不正だったり、その行が存在しなかった場合、ErrorLevel1になり、OutputVarは空になる。
Selected エディットコントロールの選択内容。
何も選択されていない場合、OutputVarは空になるが、ErrorLevel0になる。
Style コントロールのスタイルを8桁の16進数値として取得する。
スタイルを表す16進数値の論理和が取得される。
詳しくはスタイル一覧を参照。
ExStyle コントロールの拡張スタイルを8桁の16進数値として取得する。
スタイルを表す16進数値の論理和が取得される。
詳しくはスタイル一覧を参照。
Hwnd コントロールのウィンドウハンドルを取得する。

ErrorLevel[編集]

成功時は 0、失敗時は 1

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

Remarks[編集]

このコマンドは、SetControlDelayで指定するディレイは伴わない。

Related[編集]

Control, GuiControlGet, ControlMove, ControlGetText, ControlSetText, ControlGetPos, ControlClick, ControlFocus, ControlSend, WinGet

Example(s)[編集]

ControlGet, OutputVar, Line, 1, Edit1, Some Window Title
ControlGet, WhichTab, Tab, , SysTabControl321, Some Window Title
If ErrorLevel <> 0
  MsgBox There was a problem.
Else
  MsgBox Tab #%WhichTab% is active.