AutoHotKey(오토핫키) 설명서 ControlGet

→ AutoHotkey(을)를 유행시키는 페이지 → 레퍼런스 → ControlGet

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.

→ AutoHotkey(을)를 유행시키는 페이지 → 레퍼런스 → ControlGet