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.