SetBatchLines

자동적으로 실행된다Sleep의 간격을 설정(실행 속도와CPU부하에 영향)

SetBatchLines, Nms

SetBatchLines, LineCount 

Parameters

Remarks

지정행수커멘드를 실행할 때 마다Sleep그리고 쉬는지, 항상 일정한 간격으로 쉬는지를 설정할 수 있다.

디폴트의 설정치는 「10ms」(이어)여,10밀리 세컨드 실행할 때 마다10밀리 세컨드 쉰다고 하는 동작이 된다.

스크립트의 실행 속도는,SetWinDelay, SetControlDelay, SetKeyDelay, SetMouseDelay, SetDefaultMouseSpeed(으)로의 간격등의 지정에도 영향을 받는다.

이 설정의 기본치는, 스크립트의 최초의AutoExecute섹션그리고 설정한다.
hot key등에서 새롭게 기동되었다스렛드그럼, 설정은 기본치로 설정된다.

편입 변수A_BatchLines그리고 현재의 설정치를 취득할 수 있다.

Related

SetWinDelay, SetControlDelay, SetKeyDelay, SetMouseDelay, SetDefaultMouseSpeed, Critical

Example(s)

SetBatchLines, 10ms 

SetBatchLines, 1000

SendMode

Send,SendRaw,Click커멘드 및Mouse계 커멘드의 처리 방식을 변경한다

SendMode Mode

Parameters

Event모드

일정한 간격을 열면서, 개개의 조작 이벤트를 생성한다.
조작의 재생중에 유저가 간 조작이 끼어들어 버리는 일이 있다.
이것을 막으려면 ,BlockInput커멘드로 유저의 조작을 무효화해 두면 좋다.

조작의 간격은,SetKeyDelay,SetMouseDelay커멘드로 설정할 수 있다.

Input모드

입력의 재생 속도가 매우 빠르다.
이 때문에, 재생중에 예기치 못한 윈도우가 나타나고 동작을 방해할 수 있다고 말했던 것이 막을 수 있다.
또, 재생중에 유저가 간 조작은, 재생 종료후까지 뒷전으로 된다.

이 모드에서는, 한 번에 실시할 수 있는 조작의 수는5000개정도까지 제한되고 있다.
이것을 넘은 만큼은 무시된다.

다른 프로그램이 하위 레벨 키 훅을 사용하고 있으면,Input모드는 성능이 크게 저하해 버린다.
이 때문에, 다른AutoHotkey스크립트가 훅을 이용하고 있는 경우,Input모드는 자동적으로Event모드로 변경된다.
또,Windows95/NT그럼 이 모드는 이용하지 못하고, 똑같이Event모드로 변경된다.

「CoordMode,Mouse,Relative」(으)로 마우스 조작의 좌표를 액티브 윈도우의 좌상으로부터의 상대 좌표로서 취급하도록(듯이) 설정되어 있을 때,Send커멘드내의 「{Click}」조작의 기준 좌표는 커멘드가 개시한 시점으로의 액티브 윈도우의 좌상 좌표가 된다.
이 때문에, 도중에 액티브 윈도우가 변하거나 하면, 기대 그대로의 동작이 되지 않는 것이 있다.
Send커멘드를 여러 차례로 나누고,Click의 전에 윈도우의 변화가 생기지 않게 하면, 이 문제는 발생하지 않는다.

이 모드에서는, 일절 사이를 열지 않고 모든 조작이 재생된다.
SetKeyDelay커멘드로 간격을 설정할 수 없다.
Input모드를 사용하지 못하고Event모드로 변경되었을 경우는, 「SetKeyDelay,-1,0」(을)를 지정했을 때의 동작이 된다.
다만, 「SetKeyDelay,-1,-1」(이)가 설정되어 있는 경우는, 그 설정에 따른다.

Play모드

Play모드에서는, 일련의 조작이 액티브 윈도우에 대해서 일시에 이송된다.
Input모드보다는 저속이지만, 「SetKeyDelay,-1,-1」(이)가 설정되었다Event모드보다는 고속으로 동작한다.
「SetKeyDelay,10,10,Play」(와)과 같이 하면,Event모드와 같게 각 키 조작동안에 일정한 간격을 열게 할 수 있다.

재생중에 유저가 간 조작은, 재생 종료후까지 뒷전으로 된다.
다만,Windows키를 포함한 시스템의 hot key만은 동작하기 위해(때문에), 스타트 메뉴등에 의해 그래가 방해할 수 있는 경우가 있다.
AutoHotkey하지만키보드 훅(을)를 사용하고 있는 경우, 자동적으로Windows키가 무효화되어 오동작을 방지한다.

Play모드로Windows키(LWin,RWin)(을)를 눌러도,Win+R등의 hot key는 반응하지 않는다.
또,CapsLock,NumLock,ScrollLock키의 타글 상태를 변경하는 것도 할 수 없다.

재생중에Ctrl+Alt+Del(이)나Ctrl+Esc하지만 밀리면, 재생은 도중에 종료해, 스크립트의 다음이 실행된다.

Play모드로 생성한 키의 눌러 인하 상태는,GetKeyState등에서 검출할 수 없다.
스크립트 자신의 윈도우에 보내졌을 때 만은 예외적으로 검출할 수 있지만, 「RShift」등과 같이 수식 키의 좌우를 구별할 수 없다.

Remarks

Send커멘드에는, 상기의3개의 모드에 대응하는 커멘드로서 「SendEvent」 「SendInput」 「SendPlay」커멘드가 준비되어 있다.
이러한 커멘드를 이용하는 것으로, 일시적으로SendMode의 설정과는 다른 방식으로 입력의 생성을 실시할 수 있다.
마우스 조작도, 「SendPlay,{Click}」(와)과 같이 해 발생 당한다.

어느 모드도, 특정의 어플리케이션을 능숙하게 조작할 수 없는 경우가 있다.
조작하고 싶은 어플리케이션에 따라 구분하여 사용할 필요가 있다.

이 설정의 기본치는, 스크립트의 최초의AutoExecute섹션그리고 설정한다.
hot key등에서 새롭게 기동되었다스렛드그럼, 설정은 기본치로 설정된다.

Related

Send, SetKeyDelay, SetMouseDelay, Click, MouseClick, MouseClickDrag, MouseMove

Examples

SendMode Input
SendMode InputThenPlay

Send/SendRaw/SendEvent/SendInput/SendPlay

키스트로크(keystroke)를 발생시킨다

Send, Keys
SendRow, Keys
SendEvent, Keys
SendInput, Keys
SendPlay, Keys

Parameters

Remarks

수식 키

hot key의 지정과 같은 수식 키(+=Shift,^=Ctrl,!=Alt,#=Win)(을)를 키명의 전에 붙이면, 수식 키를 누른 것이 된다.

키명

영숫자나, 특별한 의미를 가지지 않는 기호는, 그대로 기술하면 좋다.
Shift(을)를 누르면서 나오는 문자는,Shift+문자의 키가 송신된다.
그 외의 키는, 이하와 같이 「{}」(으)로 둘러싸 지정한다.

{vkXX}(이)나{vkXXscYYY}(와)과 같이 하고, 가상 키코드가XX의 키나, 스캔 코드가YYY의 키를 지정 가능.

연속한 입력

{BS 5}(와)과 같이, 「{}」(으)로 둘러싸고, 오른쪽으로 수치를 지정하면, 여러 차례 누를 수 있다.

눌러 내려 밀어 올려

{Ctrl Down}(이)나{Ctrl Up}(와)과 같이, 「{}」(으)로 둘러싸고,Down(이)나Up(을)를 지정하면, 키를 눌러 그대로 하거나 밀리고 있는 키를 떼어 놓거나 할 수 있다.
수식 키 뿐만이 아니라, 보통 키도 누르고 있을 뿐으로 할 수 있는 것 같지만, 키 반복은 발생하지 않는 모양.

수식 키의 자동 복원

Send커멘드가 시작될 때, 가상적으로 수식 키를 떼어 놓은 상태가 된다.
커멘드 종료시에, 다시 원래의 상태에 되돌려진다.
이 동작은,Keys의 최초로 「{Blind}」(을)를 붙이는 것으로 무효화할 수 있다.

키보드 훅이 사용되고 있는 경우, 물리적인 눌러 인하 상태와 같은 상태에 복원되지만, 훅이 사용되어 있지 않은 경우, 지정 시간이 경과하고 있으면 복원은 실시하지 않고, 지정 시간이 경과하고 있지 않으면Send커멘드 개시전 상태에 복원된다.
이 때의 지정 시간은#HotkeyModifierTimeout지령으로 설정 가능.

특수 기호의 이스케이프와 이스케이프의 불필요한SendRaw커멘드

수식 키를 지정하는 기호나 「{」 「}」 등은, 「{{}}」(와)과 같이 「{}」(으)로 둘러싸면 입력할 수 있다.
SendRaw커멘드는, 수식 키나 특수 키명을 해석하지 않고,Keys인수의 텍스트를 그대로 타이프 치므로, 이러한 기호를 이스케이프 할 필요가 없어진다.

통상의Send커멘드 및ControlSend커멘드에서는,Keys에 「{Raw}」(이)가 포함되면, 그 이후가SendRaw(와)과 같이 수식 키나 특수 키명을 해석하지 않고 보내지게 된다.

SendEvent/SendInput/SendPlay

상기의3커멘드는,Send(와)과 기능은 같지만 입력 생성의 실현 방식이 다르다.
Send커멘드는 통상,SendEvent(와)과 같은 방식을 사용하지만,SendMode커멘드를 사용하는 것으로SendInput(이)나SendPlay의 방식으로 변경할 수 있다.
각각의 모드의 차이 등은,SendMode의 페이지 참조.

특수 키명 일람

Related

SetKeyDelay, SetStoreCapslockMode, ControlSend, WinActivate

Example(s)

Send, Sincerely,{enter}John Smith

Send, !fs ; Select the File->Save menu (Alt+F followed by S).

RunAs

Run(이)나RunWait때, 다른 유저의 권한으로 기동하는 것을 가능하게 한다.(2000/XP전용)

RunAs [, User, Password, Domain] 

Parameters

Remarks

인수 없이 실행하면, 통상 상태로 돌아온다.

이 커멘드를 실행해도ErrorLevel(은)는 변화하지 않는다.
유저명등이 잘못되어 있었을 경우,Run(이)나RunWait커멘드를 실행했을 때에 에러 메세지가 나온다.

이 커멘드가 유효하게 되어 있을 때는,Run(이)나RunWait커멘드의 인수에 실행 파일 이외를 지정해 열게 하거나 하는 것은 할 수 없다.

이 커멘드는"Secondary Logon"서비스가 정지하고 있으면 동작하지 않는다.

Related

Run, RunWait

Example(s)

RunAs, Administrator, MyPassword
Run, RegEdit.exe
RunAs ; Reset to normal behavior.

Run / RunWait

외부 프로그램을 기동한다.
RunWait그럼, 기동한 프로그램의 종료를 기다려,ErrorLevel에 종료 코드를 격납한다.

Run, Target [, WorkingDir, Max|Min|Hide/UseErrorLevel, OutputVarPID]
Run, Target [, WorkingDir, Max|Min|Hide]

Parameters

Remarks

지정한 파일이 발견되지 않고 기동에 실패하면, 에러 다이얼로그가 표시되어 현재의 스렛드를 종료한다.

RunWait그리고 종료를 기다리고 있는 동안은, 다른스렛드하지만 끼어드는 것이 가능.

EnvSet커멘드로 환경 변수에 대입하고 있으면, 기동된 프로그램내에서 그 환경 변수가 유효하게 된다.

파일명의 전으로 지정하는 동작으로서는, 이하의 것이 사용 가능.
동작을 지정하지 않고, 파일명만을 지정했을 경우, 디폴트의 동작이 된다.

Related

RunAs,Process, Exit

Example(s)

Run, Notepad.exe, C:\My Documents, max
RunWait, %comspec% /c dir c:\ >>c:\DirTest.txt, , min
Run, c:\DirTest.txt
Run, properties c:\DirTest.txt
Run, www.autohotkey.com ; i.e. any URL can be launched.
Run, mailto:support@autohotkey.com

Round()

주어진 수치를 사사오입 하는 함수

Round(N [ , Place])

Parameters

Remarks

Place(을)를 생략 했을 경우는, 소수점 이하를 사사오입 하고 정수가 돌아간다.
Place에 부의 수를 지정했을 경우는, 소수점보다 위에서 사사오입 된다. Place에 정의 수를 지정했을 경우는 소수치가, 그 이외는 정수치가 돌아간다.
N하지만 수치가 아니었던 경우나, 계산 불능인 값이 주어졌을 경우는, 길이 제로의 공문자열이 돌아간다.

Related

함수

Return

Gosub(이)나Hotkey의 써브루틴 처리로부터 돌아온다

Return

Remarks

GoSub그리고 점프 하고 있지 않을 때에Return(을)를 실행하면,Exit(을)를 실행했을 때와 같게스렛드(을)를 종료한다.

Related

Gosub, Exit, ExitApp, GroupActivate

Example(s)

#z::
MsgBox, The Win-Z hotkey was pressed.
Gosub, WinZ

return

WinZ: 
Sleep, 1000
return

Reload

현재 실행중의 스크립트를 재독 봐

Reload 

Remarks

스크립트를 재독 봐.
스크립트 실행중에 스크립트에 수정을 더했을 때, 그것을 반영시킬 수 있다.

스크립트의 동작을 확인하면서 조정을 실시하는 경우, hot key에 할당해 두면 편리.

task tray 메뉴의 「Reload This Script」와 같다.

Reload커멘드가 실행된 뒤도, 스크립트는 이후의 행의 실행을 계속해 새롭게 실행된 프로세스가 정상적으로 스크립트를 개시할 수 있던 시점에서, 원의 프로세스가 종료된다.
스크립트가 문법 에러등에서 리로드 불가능한 경우, 원의 프로세스는 그대로 실행된다.
따라서,Reload커멘드의 후에는Return커멘드를 쓰는 등, 불필요한 커멘드가 실행되어 버리는 것을 막을 필요가 있다.
또,Reload커멘드의 후에 리로드 실패시의 동작을 쓰는 것도 가능하다.

Related

Edit

Example(s)

#z::Reload

;어떠한 이유로 리로드에 실패했을 때에 특정의 처리를 하는 예
#z::
Reload
Sleep,500
MsgBox,리로드 실패
return

;리로드 실행 후에, 문법 에러가 표시되면,VxEditor그리고 해당행을 표시하는 예.

#z::
Reload
WinWait,ahk_class #32770,Error at line ,2
If ErrorLevel=0
{
	ControlGetText,v,Static1
	StringGetPos,p,v,.
	p-=14
	StringMid,line,v,15,%p%
	Run,D:\app\Document\VxEditor\VxEditor.exe "%A_ScriptFullPath%" /j%line%
	WinWaitNotActive
	WinActivate
}
return

RegWrite

레지스트리에 값을 쓴다

RegWrite, ValueType, RootKey, SubKey [, ValueName, Value]

Parameters

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

레지스트리에의 기입은 위험을 수반하므로, 신중하게 실시하는 것.

ValueType하지만REG_DWORD의 경우,Value(은)는 부호 없음 정수로 지정한다.16진수로의 지정도 가능.

REG_BINARY의 경우,Value(은)는 「01A9FF77......」(와)과 같은16진수열로 지정한다.

REG_MULTI_SZ의 경우,Value하LF(`n)단락의 문자열로 지정한다.
제일 마지막`n(은)는 무시된다.
하늘 항목은 용서되지 않기 때문에,`n(을)를 복수 계속해 포함해선 안 된다.

Windows9x계에서는,64KB이상의 내용은 취급할 수 없다.
또,REG_BINARY(와)과Reg_MULTI_SZ그럼,OS에 관계없이64KB이상의 값은 취급할 수 없다.
이 상한을 넘었을 경우, 최초의64KB만이 써진다.

registry-loop(을)를 사용하면, 복수의 키에 같은 조작을 실시할 수 있다.

Related

RegDelete, RegRead, Registry-loop

Example(s)

RegWrite, REG_SZ, HKEY_LOCAL_MACHINE, SOFTWARE\TestKey, MyValueName, Test Value

RegWrite, REG_BINARY, HKEY_CURRENT_USER, Software\TEST_APP, TEST_NAME, 01A9FF77

RegWrite, REG_MULTI_SZ, HKEY_CURRENT_USER, Software\TEST_APP, TEST_NAME, Line1`nLine2

RegRead

레지스트리로부터 값을 읽어낸다

RegRead, OutputVar, RootKey, SubKey [, ValueName]

Parameters

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

취급할 수 있는 값의 종류는 이하의 것만.

• REG_SZ
• REG_EXPAND_SZ
• REG_MULTI_SZ
• REG_DWORD
• REG_BINARY

REG_DWORD(은)는 부호 없음 정수로서 읽어내진다.

REG_BINARY의 값은, 「01A9FF77......」(와)과 같은16진수열로서 읽어내진다.

REG_MULTI_SZ하LF(`n)단락의 텍스트로서 읽어내진다.

Windows9x계에서는,64KB이상의 내용은 취급할 수 없다.
또,REG_BINARY형식의 값으로는,OS에 관계없이64KB이상의 값은 취급할 수 없다.

registry-loop(을)를 사용하면, 복수의 키에 같은 조작을 실시할 수 있다.

Related

RegDelete, RegWrite, Registry-loop

Example(s)

RegRead, OutputVar, HKEY_LOCAL_MACHINE, SOFTWARE\Microsoft\Windows\CurrentVersion, ProgramFilesDir
MsgBox, Program files are in: %OutputVar%