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は空になり、ErrorLevelが 1 になる。
| |
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 の値が不正だったり、その行が存在しなかった場合、ErrorLevelが 1 になり、OutputVarは空になる。
| |
Selected | エディットコントロールの選択内容。 何も選択されていない場合、OutputVarは空になるが、ErrorLevelは 0 になる。
| |
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.