AutoHotKey(오토핫키) 설명서 WinHide

Posted by 발전소장
2014. 8. 14. 14:31 AutoHotKey/Commands

WinHide

윈도우를 비표시로 한다

WinHide [, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters

인수명설명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

Remarks

비표시의 윈도우를 표시시키려면 ,WinShow커멘드를 사용한다.

Related

WinShow, SetTitleMatchMode, DetectHiddenWindows, Last Found Window, WinSet

Example(s)

Run, notepad.exe
WinWait, Untitled - Notepad
Sleep, 500
WinHide ; use the window found above
Sleep, 1000
WinShow


AutoHotKey(오토핫키) 설명서 WinGetTitle

Posted by 발전소장
2014. 8. 14. 14:31 AutoHotKey/Commands

WinGetTitle

지정된 윈도우의 타이틀을 취득

WinGetTitle, OutputVar [, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters

인수명설명
OutputVar 타이틀을 격납하는 변수명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

Remarks

마우스아래의 윈도우의 타이틀을 취득하려면 ,MouseGetPos(와)과 조합한다.

Related

WinGetActiveStats, WinGetActiveTitle, WinGetClass, WinGet, WinGetText, ControlGetText, WinGetPos

Example(s)

WinGetTitle, Title, A
MsgBox, The active window is "%Title%".


AutoHotKey(오토핫키) 설명서 WinGetText

Posted by 발전소장
2014. 8. 14. 14:30 AutoHotKey/Commands

WinGetText

지정된 윈도우의 텍스트를 취득

WinGetText, OutputVar [, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters

인수명설명
OutputVar 텍스트를 격납하는 변수명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

ErrorLevel

무엇인가 문제가 발생하면ErrorLevel하1(이)가 된다.문제가 없으면0(이)가 된다.

Remarks

AutoHotkey동고의 「AU3_Spy.exe」(으)로 표시되는 형식에서 윈도우상의 컨트롤의 텍스트를 취득한다.

각 텍스트 항목은,CR+LF(스크립트상에서는 「`r`n」라고 기술)그리고 단락지어진다.

NT계에서는, 취득할 수 있는 텍스트의 양에 상한은 없다.
거대한 텍스트를 열고 있는 텍스트 문자 편집기 등에 대해 사용하면, 대량의 메모리를 소비하게 된다.
OutputVar=」(와)과 같이 공문자열을 대입해 주면, 사용한 메모리는 개방할 수 있다.
9x계에서는, 윈도우 컨트롤 마다64KB까지 제한되고 있다.

Related

WinGetActiveStats, WinGetActiveTitle, WinGetTitle, ControlGetText, WinGetPos

Example(s)

Run, Calc.exe
WinWait, Calculator
WinGetText, text  ; The window found above will be used.
MsgBox, The text is:`n%text%


AutoHotKey(오토핫키) 설명서 WinGetPos

Posted by 발전소장
2014. 8. 14. 14:30 AutoHotKey/Commands

WinGetPos

지정된 윈도우의 위치와 사이즈를 취득

WinGetPos [, X, Y, Width, Height, WinTitle, WinText, ExcludeTitle, ExcludeText] 

Parameters

인수명설명
X, Y 윈도우의 수평 좌표와 수직 좌표를 격납하는 변수명.
생략시는 그 항목은 취득되지 않는다.
Width/Height 윈도우의 폭과 높이를 취득하는 변수명.
생략시는 그 항목은 취득되지 않는다.
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

Remarks

조건에 일치하는 윈도우가 존재하지 않는 경우, 각 변수는 모두 비운다.

WinTitle에 「Program Manager」(을)를 지정하면, 데스크탑의 사이즈를 취득할 수 있다.
이것은 스크린의 사이즈와 같게 된다.
(쉘이Explorer의 경우)

윈도우가 최소화되고 있는 경우,X(와)과Y(은)는 「-32000」 등(OS에 따라서는 다를 가능성 있어)(이)가 된다.

Related

WinMove, ControlGetPos, WinGetActiveStats, WinGetActiveTitle, WinGetTitle, WinGetText, ControlGetText

Example(s)

WinGetPos, X, Y, Width, Height, Calculator
MsgBox, Calculator is at %X%`,%Y%

WinGetPos, X, Y, , , A  ; "A" to get the active window's pos.
MsgBox, The active window is at %X%`,%Y%

IfWinExist, Untitled - Notepad
{
	WinGetPos, Xpos, Ypos  ; Uses the window found above.
	MsgBox, Notepad is at %Xpos%`,%Ypos%
}


AutoHotKey(오토핫키) 설명서 WinGetClass

Posted by 발전소장
2014. 8. 14. 14:29 AutoHotKey/Commands

WinGetClass

지정된 윈도우의 클래스명을 취득

WinGetClass, OutputVar [, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters

인수명설명
OutputVar 클래스명을 격납하는 변수명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

Remarks

윈도우의 종류를 나타내는 클래스명을 취득할 수 있다.

취득한 클래스명은, 윈도우 관련 커멘드의WinTitle(을)를 지정하는 (곳)중에 「ahk_class %OutputVar%」(와)과 같이 해 사용할 수 있다.

Related

WinGet, WinGetTitle

Example(s)

WinGetClass, class, A
MsgBox, The active window's class is "%class%".


AutoHotKey(오토핫키) 설명서 WinGetActiveTitle

Posted by 발전소장
2014. 8. 14. 14:29 AutoHotKey/Commands

WinGetActiveTitle

액티브 윈도우의 타이틀을 취득

WinGetActiveTitle, OutputVar 

Parameters

인수명설명
OutputVar 취득한 타이틀을 격납하는 변수명

Remarks

WinGetTitle, OutputVar, A」와 같은 동작.

Related

WinGetPos, WinGetActiveStats, WinGetTitle, WinGetClass, WinGetText, ControlGetText

Example(s)

WinGetActiveTitle, Title
MsgBox, The active window is "%Title%".


AutoHotKey(오토핫키) 설명서 WinGetActiveStats

Posted by 발전소장
2014. 8. 14. 14:29 AutoHotKey/Commands

WinGetActiveStats

액티브 윈도우의 타이틀과 사이즈, 위치를 취득

WinGetActiveStats, Title, Width, Height, X, Y 

Parameters

인수명설명
Title 타이틀을 격납하는 변수명
Width/Height 윈도우의 폭과 높이를 격납하는 변수명
X, Y 윈도우의 수평 좌표와 수직 좌표를 격납하는 변수명

Remarks

This command is equivalent to the following sequence:
WinGetTitle, Title, A」와「WinGetPos, X, Y, Width, Height, A」(을)를 실행하는 것과 같다.

Related

WinGetPos, WinGetActiveTitle, WinGetTitle, WinGetClass, WinGetText, ControlGetText

Example(s)

WinGetActiveStats, Title, Width, Height, X, Y
MsgBox, The active window "%Title%" is %Width% wide`, %Height% tall`, and positioned at %X%`,%Y%.


AutoHotKey(오토핫키) 설명서 WinGet

Posted by 발전소장
2014. 8. 14. 14:28 AutoHotKey/Commands

WinGet

윈도우 핸들(고유의ID)(이)나 일람, 프로세스ID등을 취득

WinGet, OutputVar [, Cmd, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters

인수명설명
OutputVar 결과를 격납하는 변수명
Cmd 무엇을 취득하는지를 지정.생략시는 「ID」.자세한 것은 아래와 같이 참조.
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

Cmd(으)로 지정하는 커멘드

ID
조건에 일치하는 제일 최초(전면)의 윈도우의 윈도우 핸들(고유의ID)
IDLast
조건에 일치하는 제일 최후(배면)의 윈도우의 윈도우 핸들(고유의ID)
윈도우가 하나 밖에 성냥 하지 않는 경우는 「ID」라고 변하지 않다.
WinActivateBottom의 매치 동작과 동등.
PID
조건에 일치하는 제일 최초(전면)의 윈도우의PID(프로세스ID). Process커멘드로 사용한다.
ProcessName
조건에 일치하는 제일 최초(전면)의 윈도우의 프로세스의 실행 파일명.
ControlList
조건에 일치하는 최초의 윈도우상의 컨트롤의ClassNN의 일람을 개행 단락으로 얻는다.
줄 순서는 컨트롤의Z순위의 순서가 되어 있다.
parsing loop그리고 하나씩 처리할 수 있다.
윈도우가 컨트롤을 포함하지 않는 경우는, 비운다.
ControlListHWND
ControlList(와)과 같지만,ClassNN대신에 컨트롤의 윈도우 핸들의 일람을 취득한다.
Count
조건에 일치하는 윈도우의 수
List
조건에 일치하는 윈도우를 모두 열거한다.
OutputVar그리고 지정한 변수에는 윈도우의 수가 대입되어 「OutputVar번호(1...)」라고 하는 이름의 변수(례:OutputVar1)에 차례로 윈도우 핸들이 격납된다.
존재하는 모든 윈도우를 열거하려면 ,WinTitle(와)과WinText(을)를 비워,ExcludeTitle에 존재 할 수 없는 타이틀을 지정한다.
MinMax
조건에 일치하는 제일 최초(전면)의 윈도우 상태를 취득한다.
최소화되고 있으면 「-1」, 최대화되고 있으면 「1」, 통상 상태라면 「0」(이)가 취득된다.
Transparent
윈도우의 불투명도.
0하지만 완전하게 불가시,255하지만 완전하게 불투명.
반투명이 아닐 때는 비운다.
TransColor
반투명화 되고 있는 색.
특정의 색이 반투명이 되어 있는 윈도우에서는 「0x00CC99」(와)과 같은 형식에서 그 색이 취득된다.그 이외의 경우는 비운다.
Style
ExStyle
윈도우의 스타일, 확장 스타일을8자리수의16진수로 얻는다.
스타일에 대해서는,윈도우 스타일 일람(을)를 참조.
특정의 스타일이 포함되어 있을까를 조사하려면 ,Transform커멘드의BitAnd(을)를 사용한다.(조사하고 싶은 스타일의 수치와의BitAnd하지만0(이)가 아니면, 포함되어 있다)

Remarks

윈도우 핸들은16진수의 형식에서 취득된다.
취득한 핸들은, 윈도우 관련 커멘드의WinTitle(을)를 지정하는 (곳)중에 「ahk_id %OutputVar%」라고 하도록(듯이) 해 사용할 수 있다.

마우스 커서아래의 윈도우의 핸들을 취득하려면 ,MouseGetPos커멘드를 사용한다.

Related

WinGetClass, WinGetTitle, MouseGetPos, GroupAdd

Example(s)

WinGet, active_id, ID, A
WinMaximize, ahk_id %active_id%
MsgBox, The active window's ID is "%active_id%".
; This next example will visit all open windows and display info
; about each of them:
WinGet, id, list, , , Program Manager
Loop, %id%
{
	StringTrimRight, this_id, id%a_index%, 0
	WinActivate, ahk_id %this_id%
	WinGetClass, this_class, ahk_id %this_id%
	WinGetTitle, this_title, ahk_id %this_id%
	MsgBox, 4, , Visiting All Windows`n%a_index% of %id%`nahk_id %this_id%`nahk_class %this_class%`n%this_title%`n`nContinue?
	IfMsgBox, NO, break
}
Example #3: Extract the individual control names from a ControlList:
WinGet, ActiveControlList, ControlList, A
Loop, Parse, ActiveControlList, `n
{
	MsgBox, 4,, Control #%a_index% is "%A_LoopField%". Continue?
	IfMsgBox, No
		break
}

Example #4: Display in real time the active window's control list:
#Persistent
SetTimer, WatchActiveWindow, 200
return
WatchActiveWindow:
WinGet, ControlList, ControlList, A
ToolTip, %ControlList%
return


AutoHotKey(오토핫키) 설명서 WinExist()

Posted by 발전소장
2014. 8. 14. 14:28 AutoHotKey/Commands

WinExist()

조건에 일치하는 윈도우가 존재할 때, 그 윈도우의 핸들을 돌려주는 함수

WinExist("WinTitle" [ , "WinText", "ExcludeTitle", "ExcludeText"]) 

Parameters

인수명설명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

Remarks

조건에 일치하는 윈도우가 있으면, 그 윈도우 핸들을, 존재하지 않으면 「0」(을)를 돌려준다.

Related

함수, IfWinExist, WinGet


AutoHotKey(오토핫키) 설명서 WinClose

Posted by 발전소장
2014. 8. 14. 14:27 AutoHotKey/Commands

WinClose

윈도우를 닫는다

WinClose [, WinTitle, WinText, SecondsToWait, ExcludeTitle, ExcludeText]

Parameters

인수명설명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
SecondsToWait 윈도우가 완전하게 닫혀질 때까지 대기하는 시간.
생략시는 일절 기다리지 않는다.「0」(을)를 지정하면,500밀리 세컨드 기다린다.
WinWaitClose의 기능과 닮아 있지만,ErrorLevel그리고 윈도우가 닫혀졌는지를 취득하는 것은 할 수 없다.
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

Remarks

윈도우에 대해 윈도우를 닫는 메세지를 송신해 윈도우를 닫게 한다.
그것에 의해 발생하는 동작은 어플리케이션에 따라서 다르다.

조건에 일치하는 윈도우 가운데, 액티브한 윈도우인가, 제일 전면의 윈도우가 대상이 된다.

WinKill커멘드를 사용하면, 강제적으로 윈도우를 닫을 수도 있다.

Related

WinKill, WinWaitClose, WinActivate, SetTitleMatchMode, DetectHiddenWindows, Last Found Window, IfWinExist, IfWinActive, WinWaitActive, WinWait, GroupActivate

Example(s)

IfWinExist, Untitled - Notepad
	WinClose ; use the window found above
else
	WinClose, Calculator