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」。

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.