AutoHotKey(오토핫키) 설명서 WinWaitClose

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

WinWaitClose

윈도우가 닫는다(존재하지 않게 된다)의를 기다린다

WinWaitClose[, WinTitle, WinText, Seconds , ExcludeTitle, ExcludeText]

Parameters

인수명설명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
Seconds 최대몇 초간까지 기다릴까.
생략시는 무한하게 기다린다.
0(을)를 지정하면0.5초 기다린다.
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

ErrorLevel

0
윈도우가 존재하지 않게 되었다
1
윈도우가 존재하지 않게 되기 전에Seconds그리고 지정한 시간이 경과했다

Remarks

조건에 일치하는 윈도우가 존재하면, 존재하지 않게 될 때까지 최대로Seconds그리고 지정한 시간까지 대기한다.
조건에 일치하는 윈도우가 존재하지 않게 되면, 곧바로 다음의 처리로 옮긴다.

대기중은 hot key나 타이머등에서 기동되었다스렛드하지만 끼어들 수 있다.

이 커멘드의 인수에 사용되고 있는 변수의 내용이, 끼어든 스렛드에 의해서 변경되어도, 대기중의 이 커멘드에는 영향을 주지 않고, 커멘드 개시시에 변수에 들어가 있던 내용이 그대로 사용된다.

Related

WinClose, WinWait, WinWaitActive, IfWinExist, IfWinActive, SetTitleMatchMode, DetectHiddenWindows

Example(s)

Run, notepad.exe
WinWait, Untitled - Notepad
WinWaitClose ; Wait for the exact window found by WinWait to be closed.
MsgBox, Notepad is now closed.


AutoHotKey(오토핫키) 설명서 WinWaitActive / WinWaitNotActive

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

WinWaitActive / WinWaitNotActive

지정한 윈도우가 액티브하게 될 때까지 대기

WinWaitActive [, WinTitle, WinText, Seconds, ExcludeTitle, ExcludeText]
WinWaitNotActive [, WinTitle, WinText, Seconds, ExcludeTitle, ExcludeText]

Parameters

인수명설명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
Seconds 최대몇 초간까지 기다릴까.
생략시는 무한하게 기다린다.
0(을)를 지정하면0.5초 기다린다.
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

ErrorLevel

0
윈도우가 액티브·비액티브하게 되었다
1
윈도우가 액티브·비액티브하게 되기 전에Seconds그리고 지정한 시간이 경과했다

Remarks

조건에 일치하는 윈도우가 액티브하게 되면, 그 윈도우가LastFoundWindow(으)로서 기억되어 스크립트는 곧바로 다음의 처리로 옮긴다.
LastFoundWindow에 대해서는윈도우 지정의 방법참조.

대기중은 hot key나 타이머등에서 기동되었다스렛드하지만 끼어들 수 있다.

이 커멘드의 인수에 사용되고 있는 변수의 내용이, 끼어든 스렛드에 의해서 변경되어도, 대기중의 이 커멘드에는 영향을 주지 않고, 커멘드 개시시에 변수에 들어가 있던 내용이 그대로 사용된다.

Example(s)

Run, notepad.exe
WinWaitActive, Untitled - Notepad, , 2
if ErrorLevel <> 0
{
	MsgBox, WinWait timed out.
	return
}
else
	WinMinimize  ; minimize the window found by WinWaitActive.


AutoHotKey(오토핫키) 설명서 WinWait

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

WinWait

지정한 윈도우가 존재하게 되는 것을 기다린다

WinWait[, WinTitle, WinText, Seconds , ExcludeTitle, ExcludeText]

Parameters

인수명설명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
Seconds 최대몇 초간까지 기다릴까.
생략시는 무한하게 기다린다.
0(을)를 지정하면0.5초 기다린다.
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

ErrorLevel

0
윈도우가 발견되었다
1
윈도우가 발견되기 전에Seconds그리고 지정한 시간이 경과했다

Remarks

윈도우가 발견되면, 그 윈도우가LastFoundWindow(으)로서 기억되어 스크립트는 곧바로 다음의 처리로 옮긴다.
LastFoundWindow에 대해서는윈도우 지정의 방법참조.

대기중은 hot key나 타이머등에서 기동되었다스렛드하지만 끼어들 수 있다.

이 커멘드의 인수에 사용되고 있는 변수의 내용이, 끼어든 스렛드에 의해서 변경되어도, 대기중의 이 커멘드에는 영향을 주지 않고, 커멘드 개시시에 변수에 들어가 있던 내용이 그대로 사용된다.

Related

WinWaitActive, WinWaitClose, IfWinExist, IfWinActive, SetTitleMatchMode, DetectHiddenWindows

Example(s)

Run, notepad.exe
WinWait, Untitled - Notepad, , 2
if ErrorLevel <> 0
{
	MsgBox, WinWait timed out.
	return
}
else
	WinMinimize  ; minimize the window found by WinWait.


AutoHotKey(오토핫키) 설명서 WinShow

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

WinShow

비표시의 윈도우를 표시한다

WinShow [, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters

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

Remarks

이 커멘드는DetectHiddenWindows에 의한 설정에 관계없이, 비표시의 윈도우를 대상으로 할 수 있다.

Related

WinHide, SetTitleMatchMode, DetectHiddenWindows, Last Found Window

Example(s)

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


AutoHotKey(오토핫키) 설명서 WinSetTitle

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

WinSetTitle

윈도우의 타이틀을 변경

WinSetTitle, NewTitle
WinSetTitle, WinTitle, WinText, NewTitle [, ExcludeTitle, ExcludeText] 

Parameters

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

Remarks

당겨 수를 하나만 지정하면,LastFoundWindow의 윈도우가 당겨 수로 지정한 타이틀이 된다

Related

WinMove, WinGetActiveStats, WinGetActiveTitle, WinGetText, ControlGetText, WinGetPos, WinSet

Example(s)

WinSetTitle, Untitled - Notepad, , This is a new title
; Alternate:
Run, notepad.exe
WinWaitActive, Untitled - Notepad
WinSetTitle, This is a new title ; Uses the window found above by WinWaitActive


AutoHotKey(오토핫키) 설명서 WinSet

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

WinSet

윈도우를 항상 맨 앞면표시 상태로 하거나 반투명으로 하거나 한다

WinSet, SubCmd, Value [, WinTitle, WinText,  ExcludeTitle, ExcludeText]

Parameters

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

SubCmd,Value

Top
윈도우를 일번수전으로 이동한다.액티브하게는 안 된다.시스템의 설정에 따라서는 동작하지 않는다.
Bottom
윈도우를 다른 모든 윈도우의 뒤로 이동한다.
AlwaysOnTop ,ON|OFF|TOGGLE
Topmost ,ON|OFF|TOGGLE
항상 맨 앞면표시 상태의 설정.TOGGLE하ON/OFF(을)를 바꾼다.
Disable
윈도우를 조작 불가능하게 한다
Enable
윈도우를 조작 가능하게 한다
Redraw
윈도우를 재묘화 시킨다.
Style,N|ExStyle,N
윈도우의 스타일을 설정한다.
N(으)로 지정하는 값에 대해서는,윈도우 스타일 일람(을)를 참조.
N의 전에 「+」(을)를 붙이면, 그 스타일을 기존의 스타일에 추가, 「-」(을)를 붙이면 스타일을 삭제, 「^」(을)를 붙이면 스타일의 유무를 반전.
ErrorLevel(은)는, 정상 종료시는 「0」, 적용 불가능한 스타일을 지정했을 경우 등은 「1」(이)가 된다.
Region[,Options]
윈도우의 표시 영역을 변경한다.
Options(을)를 생략 했을 경우, 통상 표시로 돌아온다.
Options에는, 이하의 것을 반각 스페이스 단락으로 지정한다.
ErrorLevel(은)는, 정상 종료시는 「0」, 적용 불가능한 스타일을 지정했을 경우 등은 「1」(이)가 된다.
Wn Hm x-y
폭n높이m의 구형의 범위를 표시한다.x,y하지만 구형의 좌상의 좌표(윈도우의 좌상으로부터의 상대 좌표)(이)가 된다.부의 값도 지정 가능.(례:「W640 H480 10-10」 「W640 H480 -10--10」)
Rw-h Wn Hm x-y
모퉁이의 둥근 구형으로 한다.모퉁이는 폭w, 높이h의 타원이 된다.(례:「R30-30」)
단지 「R」라고 했을 경우, 「R30-30」라고 한 것이 된다.
E Wn Hm x-y
구형 대신에, 구형에 접하는 타원이 된다.
x1-y1 x2-y2 x3-y3 ...
각xn-yn의 조를 정점으로 한 다각형의 영역을 표시한다.(례:「0-0 0-30 30-0」)
「100-100 0-100 100-0」로서|×|형태로 하거나 하는 일도 가능.
최대2000조까지 지정 가능.
Wind x1-y1 x2-y2 x3-y3 ...
Alternating메소드 대신에Winding메소드를 사용한다(?)
Transparent ,0...255|OFF
Trans ,0-255|OFF
윈도우를 반투명으로 한다.( 2000/XP전용)
0...255의 사이에 투명도를 지정.(0그리고 완전하게 불가시)
「OFF」(을)를 지정하면, 반투명을 완전하게 해제한다.(255(으)로 한 것 만으로는, 반투명의 계산을 하기 위해, 퍼포먼스가 나빠진다)
TransColor ,Color [N]
윈도우의 지정한 색 부분만큼을 투명하게 한다(XP전용)
투명하게 된 부분은 클릭하지 못하고, 아래의 윈도우가 클릭된다. Color에는 투명하게 하고 싶은 색을색의 이름인가RRGGBB의 서식에서 지정.
N에 투명도를0...255의 값으로 지정할 수 있다.(례:「WinSet, TransColor, EEAA99 150)
윈도우의 투명색을 변경하는 경우는, 일단Transparent,OFF(을)를 실행해 투명화를 해제할 필요가 있다.
GUI윈도우로 「Gui,-Caption」(을)를 병용 하는 경우는, 먼저 「WinSet,TransColor」(을)를 실행해 둘 필요가 있다.

Related

WinGet, WinHide, WinSetTitle, WinMove, WinActivate

Example(s)

WinSet, Transparent, 200, Untitled - Notepad ; Make the window a little bit transparent.
WinSet, TransColor, White, Untitled - Notepad ; Make all white pixels invisible.
WinSet, AlwaysOnTop, toggle, Calculator ; Toggle the always-on-top status of Calculator.

; Longer Example:
; Here are some hotkeys that demonstrate the effects of "Transparent" and
; "TransColor".  NOTE: If you press one of the hotkeys while the mouse cursor
; is hovering over a pixel that is invisible as a result of TransColor, the window
; visible beneath that pixel will be acted upon instead!  Also, Win+G will
; have an effect only on Windows XP because retrieval of transparency settings
; is not supported by Windows 2000:

#t::  ; Press Win+T to make the color under the mouse cursor invisible.
MouseGetPos, MouseX, MouseY, MouseWin
PixelGetColor, MouseRGB, %MouseX%, %MouseY%, RGB
; In seems necessary to turn off any existing transparency first:
WinSet, TransColor, Off, ahk_id %MouseWin%
WinSet, TransColor, %MouseRGB% 220, ahk_id %MouseWin%
return

#o::  ; Press Win+O to turn off transparency for the window under the mouse.
MouseGetPos,,, MouseWin
WinSet, TransColor, Off, ahk_id %MouseWin%
return

#g::  ; Press Win+G to show the current settings of the window under the mouse.
MouseGetPos,,, MouseWin
WinGet, Transparent, Transparent, ahk_id %MouseWin%
WinGet, TransColor, TransColor, ahk_id %MouseWin%
ToolTip Translucency:`t%Transparent%`nTransColor:`t%TransColor%
return

; Examples of "WinSet Region":
WinSet, Region, 50-0 W200 H250, WinTitle  ; Make all parts of the window outside this rectangle invisible.
WinSet, Region, 50-0 W200 H250 R40-40, WinTitle  ; Same as above but with corners rounded to 40x40.
WinSet, Region, 50-0 W200 H250 E, WinTitle  ; An ellipse instead of a rectangle.
WinSet, Region, 50-0 250-0 150-250, WinTitle  ; A triangle with apex pointing down.
WinSet, Region,, WinTitle ; Restore the window to its original/default display area.

; Here is a region with a more complex area. It creates a see-through rectangular hole inside a window.
; There are two rectangles specified below: an outer and an inner.  Each rectangle consists of 5 pairs
; of X/Y coordinates because the first pair is repeated at the end to "close off" each rectangle.
WinSet, Region, 0-0 300-0 300-300 0-300 0-0   100-100 200-100 200-200 100-200 100-100, WinTitle


AutoHotKey(오토핫키) 설명서 WinRestore

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

WinRestore

윈도우의 최소화나 최대화를 바탕으로 되돌린다

WinRestore [, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters

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

Remarks

일부의 윈도우는 이 방법에서는 복원할 수 없다.
대신에 이하의 방법을 사용하면, 복원할 수 있는 경우가 있다.

PostMessage, 0x112, 0xF120,,, WinTitle, WinText ; 0x112 = WM_SYSCOMMAND, 0xF120 = SC_RESTORE

Related

WinMinimize, WinMaximize

Example(s)

WinRestore, Untitled - Notepad


AutoHotKey(오토핫키) 설명서 WinMove

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

WinMove

윈도우의 위치나 사이즈를 변경한다

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

Parameters

인수명설명
WinTitle 윈도우 타이틀 등.
윈도우 지정의 방법참조.
WinText 윈도우에 포함되는 텍스트
X, Y 윈도우가 새로운 수평 좌표와 수직 좌표를 지정.
Width, Height 윈도우의 새로운 폭과 높이를 지정.생략시는 변경 없음.
ExcludeTitle 제외 타이틀
ExcludeText 제외 텍스트

Remarks

2개의 정수를 당겨 수라고 했을 경우,LastFoundWindow(을)를 그 위치로 이동한다.

Width(이)나Height에 일정치보다 작은 사이즈를 지정했을 경우, 타이틀 바의 아이콘과 버튼등이 표시되는 최소한의 사이즈가 된다.

X(이)나Y에는, 윈도우가 스크린으로부터 사라져 버리는 값도 지정 가능.

최소화되고 있는 윈도우는 이동할 수 없다.
DetectHiddenWindows하지만On(이)라면, 비표시의 윈도우도 이동할 수 있다.

Related

ControlMove, WinGetPos, WinHide, WinMinimize, WinMaximize, WinSet

Example(s)

Run, calc.exe
WinWait, Calculator
WinMove, 0, 0 ; Move the window found by WinWait.
SplashTextOn, 400, 300, Clipboard, The clipboard contains:`n%clipboard%
WinMove, Clipboard, , 0, 0 ; Move the splash window to the top left corner. 
Msgbox, Press OK to dismiss the SplashText
SplashTextOff
; The following function centers the specified window on the screen:
CenterWindow(WinTitle)
{
	WinGetPos,,, Width, Height, %WinTitle%
	WinMove, %WinTitle%,, (A_ScreenWidth/2)-(Width/2), (A_ScreenHeight/2)-(Height/2)
}


AutoHotKey(오토핫키) 설명서 WinMinimizeAll / WinMinimizeAllUndo

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

WinMinimizeAll / WinMinimizeAllUndo

모든 윈도우를 최소화한다 / 그것을 바탕으로 되돌린다

WinMinimizeAll
WinMinimizeAllUndo

Remarks

WinMinimizeAll그리고 모든 윈도우가 최소화된다.
WinMinimizeAllUndo(을)를 실시하면,WinMinimizeAll그리고 최소화한 윈도우를 바탕으로 되돌린다.


AutoHotKey(오토핫키) 설명서 WinMinimize

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

WinMinimize

윈도우를 최소화한다

WinMinimize [, WinTitle, WinText, ExcludeTitle, ExcludeText]

Parameters

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

Remarks

최소화한 윈도우를 바탕으로 되돌리려면 ,WinRestore커멘드를 사용한다.

일부의 윈도우는 이 방법에서는 최소화할 수 없다.
대신에 이하의 방법을 사용하면, 최소화할 수 있는 경우가 있다.

PostMessage, 0x112, 0xF020,,, WinTitle, WinText ; 0x112 = WM_SYSCOMMAND, 0xF020 = SC_MINIMIZE

Related

WinRestore, WinMaximize

Example(s)

Run, notepad.exe
WinWait, Untitled - Notepad
WinMinimize ; use the window found above


^Down::WinMinimize, A  ; Assign a hotkey to minimize the active window.