Ln()

주어진 수치의 자연대수(네피아수e(을)를 바닥으로 한 대수)(을)를 돌려주는 함수

Ln(N)

Parameters

Remarks

인수가 수치가 아니었던 경우나, 계산 불능인 값이 주어졌을 경우는 길이 제로의 공문자열이 돌아간다.

Related

함수

ListVars

변수명과 변수의 내용을 일람표시

ListVars 

Remarks

스크립트가 사용한 변수명과 그 내용이 일람표 나타난다.
F5키를 누르면 최신의 정보로 갱신된다.

메인 윈도우의 「View」→「Variables」메뉴와 같다.

함수 중(안)에서 실행되었을 경우, 함수의 로컬 변수가 위에 표시된다.

리스트에는, 변수명, 변수의 길이, 변수에 확보되고 있는 기억 영역의 용량, 변수의 내용의 최초의60아르바이트가 표시된다.

Related

KeyHistory, ListHotkeys, ListLines

Example(s)

ListVars

ListLines

스크립트가 최근 실행한 커멘드를 표시

ListLines

Remarks

스크립트가 최근 실행한 커멘드를 표시.
F5키를 누르지 않는다고 표시는 갱신되지 않는다.
표시되는 행 번호는 대개 파일에 쓰여져 있는 행으로 일치하지만, 내용이 일부 차이가 나는 경우가 있다.

메인 윈도우의 「View」→「Lines most recently executed」메뉴와 같다.

Related

KeyHistory, ListHotkeys, ListVars

Example(s)

ListLines

ListHotkeys

등록되어 있는 hot key의 정보를 일람표시

ListHotkeys

Remarks

등록되어 있는 hot key와 현재 유효할지, 키, 마우스 훅이 사용되고 있는지 어떤지,스렛드하지만 기동하고 있을지를 일람표시 한다.

메인 윈도우의 「View」→「Variables」메뉴와 같다.

Related

#InstallKeybdHook, #InstallMouseHook, #UseHook, KeyHistory, ListLines, ListVars, #MaxThreadsPerHotkey, #MaxHotkeysPerInterval

Example(s)

ListHotkeys

KeyWait

키보드나 마우스, 죠이스틱의 버튼이 밀린다/떼어 놓아질 때까지 대기

KeyWait, KeyName [, Options]

Parameters

ErrorLevel

T옵션으로 지정한 초수가 경과했을 경우 「1」, 그 이외는 「0」

Remarks

Options하지만 아무것도 지정되지 않았던 경우, 지정한 키가 떼어 놓아질 때까지 계속 쭉 대기한다.

WindowsNT계로 키보드/마우스 훅이 사용되고 있는 경우, 물리적인 키/버튼 상태(유저가 실제로 키/버튼을 누르고 있을까)에 의해서 판정된다.
#InstallKeybdHook(이)나#InstallMouseHook지령으로, 강제적으로 훅을 유효하게 하는 것이 가능.

상기의 조건에 들어맞지 않는 경우, 논리적인 상태로 판정된다.
이 경우,AutoHotkey의Send커멘드와 같은 프로그램에 의해서 생성된 조작에도 반응해 버린다.

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

복수의 키가 지정 상태가 되는 것을 기다리게 한 싶은 경우는, 복수의KeyWait(을)를 연속해 실행하면 좋다

KeyWait,Control
KeyWait,Alt

복수의 키 중 어떤 것인가가 밀리는 것을 기다리고 싶은 경우는,Input커멘드를 사용한다

Related

Key List, GetKeyState, Input, KeyHistory, #InstallKeybdHook, #InstallMouseHook, ClipWait, WinWait

Example(s)

KeyWait, a  ; Wait for the A key to be released.
KeyWait, LButton, D  ; Wait for the left mouse button to be pressed down.
KeyWait, Joy1, D T3  ; Wait up to 3 seconds for the first joystick button to be pressed down.
KeyWait, LAlt, L  ; Wait for the left-alt key to be logically released.

; Hotkey example:
~Capslock::
KeyWait, Capslock  ; Wait for user to physically release it.
MsgBox You pressed and released the Capslock key.
return

; Remapping example:
; The left mouse button is kept held down while NumpadAdd is down,
; which effectively transforms NumpadAdd into the left mouse button.
*NumpadAdd::
MouseClick, left,,, 1, 0, D  ; Hold down the left mouse button.
KeyWait, NumpadAdd   ; Wait for the key to be released.
MouseClick, left,,, 1, 0, U  ; Release the mouse button.
return

; This example shows how to detect when a key has been double-pressed (similar to double-click):
; It relies on #MaxThreadsPerHotkey being at its default setting of 1.
~RControl::
if A_PriorHotkey <> ~RControl
{
	KeyWait, RControl
	return
}
if A_TimeSincePriorHotkey > 400 ; Too much time between presses, so this isn't a double-press.
{
	KeyWait, RControl
	return
}
MsgBox You double-pressed the right control key.
return

KeyHistory

키보드, 마우스의 조작 이력을 표시

KeyHistory

Remarks

입력된 조작의 키코드등을 조사할 수 있다.
hot key로키코드를 직접 지정하고 싶은 경우나,Send커멘드로 키코드 지정으로 키를 송신하고 싶은 경우는 여기서 조사하면 좋다.

메인 메뉴의 「View」→「Key history」와 같다.

#KeyHistory지령으로 기록하는 조작의 수를 설정할 수 있다.

유저가 입력한 조작을 표시하기 위해서는, 키보드 훅이나 마우스 훅을 유효하게 되어 있을 필요가 있다.
특정의 hot key를 등록하고 있으면, 자동적으로 훅은 유효하게 되지만, 확실히 훅을 유효하게 하려면 이하와 같이 한다.

#InstallKeybdHook
#InstallMouseHook

Related

#KeyHistory, #InstallKeybdHook, #InstallMouseHook, ListHotkeys, ListLines, ListVars

Example(s)

KeyHistory ; Display the history info in a window.

IsLabel()

라벨이 정의되고 있는지를 판별하는 함수

IsLabel("LabelName")

Parameters

Remarks

「Gosub,%LabelName%」(와)과 같은 동적 라벨명을 이용해 점프 할 때, 해당 라벨이 존재할지를 조사하기 위해서 사용한다.

해당 라벨에 점프 할 수 할 수 없어도, 스크립트의 어디엔가 라벨이 존재하면 「1」(이)가 돌려주어진다.
예를 들면, 타처의 함수내에서 정의되고 있는 라벨 등이다.

Related

GoSub, GoTo

Examples

if(IsLabel("Label")){
	GoSub,Label
}

Label:
MsgBox,This is Subroutine
return

InStr()

문자열중에서 검색 문자열이 최초로 출현하는 위치를 돌려주는 함수

InStr(String, Needle [, CaseSensitive=false, StartingPos=1]) 

Parameters

Remarks

String그리고 주어진 문자열 중(안)에서,Needle그리고 주어진 문자열이 최초로 출현하는 위치를 돌려준다.
String의1문자눈은 「1」로서 다루어진다.
발견되지 않았던 경우는 「0」(이)가 돌아간다.
StartingPos(을)를 「2」이상으로 설정하면,StartingPos문자눈 이후의 출현 위치를 검색한다.
StartingPos하지만String의 길이 이상이 되는 경우는, 「0」(이)가 돌아간다.
StartingPos(을)를 「0」(으)로 하면,String안의 제일 마지막Nedle의 위치가 돌아간다.
StartingPos(을)를 지정했을 경우에서도, 돌아가 값은 문자열의 선두로부터 센 위치가 된다.

Related

함수, StringGetPos

InputBox

텍스트 입력을 요구하는 윈도우를 표시한다

InputBox, OutputVar [, Title, Prompt, HIDE, Width, Height, X, Y, Font, Timeout, Default]

Parameters

ErrorLevel

0

「OK」버튼이 밀렸다

1

「Cancel」버튼이 밀렸다

2

Timeout그리고 지정한 시간이 경과했다

Remarks

텍스트 입력란과 「OK」 「Cancel」버튼이 붙은 윈도우가 표시된다.
입력란에 포커스가 있을 때Enter키를 눌렀을 경우, 「OK」버튼을 누른 것이라고 동일 취급이 된다.
윈도우의 「닫는다」버튼등을 누르고 윈도우를 닫았을 경우는, 「Cancel」버튼을 누른 것이라고 동일 취급이 된다.

「Cancel」버튼이 밀리거나Timeout의 시간이 경과했을 경우에서도,OutputVar에는 그 시점에서 입력란에 입력되고 있던 내용이 격납된다.

입력을 기다리고 있는 동안, 현재의스렛드(은)는 정지한다.
입력을 기다리고 있는 동안은, 다른 스렛드가 끼어드는 것이 가능.
끼어든 스렛드가 하나 더InputBox의 윈도우를 표시하는 일도 가능.

Gui,+OwnDialogs(을)를 사용하는 것으로,GUI윈도우의 아이 윈도우로서 다이얼로그를 표시할 수 있다.
아이 윈도우로서 다이얼로그가 표시되고 있는 동안은, 부모가 된다GUI윈도우는 조작할 수 없게 된다.

Related

Input, MsgBox, FileSelectFile, FileSelectFolder, SplashTextOn, ToolTip

Example(s)

InputBox, password, Enter Password, (your input will be hidden), hide 
InputBox, UserInput, Phone Number, Please enter a phone number., , 640, 480
if ErrorLevel <> 0
	MsgBox, CANCEL was pressed.
else
	MsgBox, You entered "%UserInput%"

Input

유저의 입력을 횡령해 취득한다(NT계 전용)

Input [, OutputVar, Options, EndKeys, MatchList]

Parameters

ErrorLevel

Remarks

이 커멘드를 사용하면, 키보드에 의한 입력을 감시하고, 입력된 텍스트를OutputVar에 격납할 수 있다.
입력의 감시는Endkeys그리고 지정된 키가 밀리는지,L옵션으로 지정한 문자수에 이르는지,T옵션으로 지정한 시간이 경과하는지,MatchList그리고 지정되어 있는 문자열에 입력이 일치하면 종료해, 종료 이유가ErrorLevel변수에 격납된다.

입력을 기다리고 있는 동안은, hot key나 메뉴등에서 새로운스렛드하지만 끼어드는 것이 가능.
끼어들어 온 스렛드로 새롭게Input커멘드가 실행되면, 끼어들어졌다Input커멘드는ErrorLevel하지만 「NewInput」가 되어 종료한다.
Input커멘드를 인수 없이 실행하면, 기존의Input커멘드의 종료만을 한다.

이 커멘드가 최초로 실행되었을 때,키보드 훅하지만 유효화 된다.
그 이후는, 스크립트가상주 상태(이)가 되어,ExitApp커멘드를 실행할 때까지 종료하지 않게 된다.

핫 스트링의 기능을 사용하면, 간단하게 특정의 키스트로크(keystroke)에 대해서 동작을 할당할 수 있다.

Related

KeyWait, InputBox, #InstallKeybdHook, Threads, StringCaseSense

Example(s)

; Wait for the user to press any key.  Keys that produce no visible character,
; such as the modifier keys, function keys, and arrow keys, are listed as end keys
; so that they will be detected too.
Input, SingleKey, L1, {LControl}{RControl}{LAlt}{RAlt}{LShift}{RShift}{LWin}{RWin}{F1}{F2}{F3}{F4}{F5}{F6}{F7}{F8}{F9}{F10}{F11}{F12}{Left}{Right}{Up}{Down}{Home}{End}{PgUp}{PgDn}{Del}{Ins}{BS}{Capslock}{Numlock}{PrintScreen}{Pause}


; This is a working hotkey example.  Since the hotkey has the tilde (~)
~[::
Input, UserInput, V T5 L4 C, {enter}.{esc}{tab}, btw,otoh,fl,ahk,ca
if ErrorLevel = Max
{
	MsgBox, You entered "%UserInput%", which is the maximum length of text.
	return
}
if ErrorLevel = Timeout
{
	MsgBox, You entered "%UserInput%" at which time the input timed out.
	return
}
if ErrorLevel = NewInput
	return
IfInString, ErrorLevel, EndKey:
{
	MsgBox, You entered "%UserInput%" and terminated the input with %ErrorLevel%.
	return
}
; Otherwise, a match was found.
SetKeyDelay, -1  ; Most editors can handle the fastest speed.
if UserInput = btw
	Send, {backspace 4}by the way
else if UserInput = otoh
	Send, {backspace 5}on the other hand
else if UserInput = fl
	Send, {backspace 3}Florida
else if UserInput = ca
	Send, {backspace 3}California
else if UserInput = ahk
	Run, www.autohotkey.com
return