AutoHotKey(오토핫키) 설명서 ControlGet

Posted by 발전소장
2014. 8. 13. 20:41 AutoHotKey/Commands

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
리스트 박스나 combobox로 지정한 문자열의 항목이 있을까(TListBox/TComboBox컨트롤에도 대응)
완전하게 일치하는 것이 있었을 경우, 그 번호(1...)하지만 취득된다.
발견되지 않았던 경우,OutputVar(은)는 비워,ErrorLevel하지만 「1」(이)가 된다.
Choice
리스트 박스나 combobox로 선택되고 있는 항목의 번호(TListBox/TComboBox컨트롤에도 대응)
List
리스트 박스나 combobox, 드롭 다운 리스트의 항목의 일람(TListBox/TComboBox컨트롤에도 대응)
각 항목은LF(`n)그리고 단락지어진다.
List,Options
리스트뷰(SysListVew32)의 정보를 취득한다.
Options(을)를 생략 했을 경우, 모든 항목의 텍스트가 개행(`n)단락으로 취득된다.각 항목의 열은Tab문자(`t)그리고 단락지어진다.
Options에는 이하의 것을 반각 스페이스 단락으로 지정한다.
Count
해당 항목의 수를 취득한다
ColN
N번째의 열의 텍스트만을 취득한다(례:「Col2」)
Selected
선택된 항목만을 대상으로 한다
Focused
포커스가 있는 항목만을 대상으로 한다
Count Col
렬수를 취득한다
LineCount
에디트 컨트롤의 현재의 행수
CurrentLine
에디트 컨트롤의 caret의 행 위치(1...)
CurrentCol
에디트 컨트롤의 caret의 자리수 위치
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.