Hotkey

스크립트 실행중에 hot key를 할당하거나 설정을 변경하거나 한다

Hotkey, KeyName [, Label, Options]
Hotkey, IfWinActive [, WinTitle, WinText]
Hotkey, IfWinExist [, WinTitle, WinText]
Hotkey, IfWinNotActive [, WinTitle, WinText]
Hotkey, IfWinNotExist [, WinTitle, WinText]

Parameters

ErrorLevel

IfWin..,계 서브 커멘드를 사용했을 경우, 설정에 성공하면0, 어떠한 문제가 발생했을 경우1(이)가 된다.

UseErrorLevel옵션을 사용했을 경우, 문제가 없으면0, 문제가 있었을 경우는 이하의 어떤 것인가가 된다.

1

Label인수로 지정된 라벨이 존재하지 않는다

2

KeyName파라미터로 지정된 키가 현재의 시스템으로 사용할 수 없는지, 원래 존재하지 않는다

3

「WheelUp & MButton」(와)과 같이, 콤비네이션 키의 프리픽스 키에 사용할 수 없는 키를 지정했다

4

AltTab(이)나ShiftAltTab에 단독의 키를 할당하려고 했다(이러한 기능에는,2개이상의 키로부터 되는 hot key를 할당할 필요가 있다)

5

설정되어 있지 않은 hot key의 설정을 갱신하려고 했다

6

hot key는 설정되어 있지만, 현재의 「IfWin...」조건하의 액션이 설정되어 있지 않을 때로 설정을 갱신하려고 했다

50

등록하려고 한 hot key가 다른 어플리케이션으로 사용되고 있어 등록할 수 없었다(Windows9x계만)

51

Windows9x계에서는 사용할 수 없는 hot key를 설정하려고 했다

98

설정할 수 있는 hot key수의 상한700개를 초과했다

99

빈메모리가 부족하고 처리에 실패했다

KeyName(와)과UseErrorLevel옵션만을 지정하는 것으로써, 그 hot key가 설정되어 있는지 어떤지를 조사할 수 있다.

Hotkey, ^!p,, UseErrorLevel
if ErrorLevel in 5,6
	MsgBox The hotkey does not exist or it has no variant for the current IfWin criteria.

Remarks

이 커멘드로 할당하는 것보다, hot key 라벨로 해서 정의하는 것이 효율이 좋다.
이 커멘드는, 스크립트로 동적으로 할당을 변경하고 싶은 경우 등에 마셔 사용한다.

하나의 라벨을 복수의 hot key에 할당할 수도 있다.
이 경우,%A_ThisHotkey%변수로 어느 hot key가 밀렸는지를 알 수 있다.

이 커멘드로 만들어진 hot key도,Suspend커멘드로 정지할 수 있다.

이 커멘드로 hot key를 등록·무효화했을 경우,키보드 훅(이)나마우스 훅(은)는 자동적으로 유효·무효가 된다.

이 커멘드로 hot key를 작성하면, 스크립트는 자동적으로 상주가 된다.

Related

#Ifwin..., Hotkey Symbols, #MaxThreadsBuffer, #MaxThreadsPerHotkey, Suspend, Threads, Gosub, Return, Menu, SetTimer

Example(s)

Hotkey, ^!z, MyLabel
return

MyLabel:
MsgBox You pressed %A_ThisHotkey%.
return

; Other examples:
Hotkey, RCtrl & RShift, AltTab ; Makes RCtrl & RShift operate like Alt-Tab.
Hotkey, #c, On
Hotkey, $+#c, Off
Hotkey, ^!a, , T5 ; Change the hotkey to allow 5 threads.

Hotkey, IfWinActive, ahk_class Notepad
Hotkey, ^!c, MyLabelForNotepad

Gui,Add,Hotkey

GUI윈도우에 키보드 쇼트 컷의 편성을 입력하기 위한 컨트롤을 추가한다

Gui, Add, Hotkey [, Options, Text]

Parameters

고유의Option

LimitN

Hotkey그리고 입력 금지로 할 수 있는 수식 키의 조를 설정한다.금지되고 있는 조를 입력하려고 하면, 대신에Ctrl+Alt의 조가 부가된다.
N에는 이하의 수의 화를 설정한다.

1

수식 키 없음을 금지(례:A)

2

Shift키만의 수식 키를 금지(례:Shift+A)

4

Ctrl키만의 수식 키를 금지(례:Ctrl+A)

8

Alt키만의 수식 키를 금지(례:Alt+A)

16

Ctrl+Shift의 수식 키를 금지(례:Ctrl+Shift+A)

32

Alt+Shift의 수식 키를 금지(례:Alt+Shift+A)

128

Ctrl+Alt+Shift의 수식 키를 금지(례:Ctrl+Alt+Shift+A)

Remarks

포커스를 대면시키면서 키를 누르면, 키와 수식 키가 입력된다.
컨트롤에는 「Ctrl + C」(와)과 같이 표시되지만,Text인수로 설정하는 디폴트치나GUI,Submit커멘드등에서 취득되는 값은,Hotkey커멘드나hot key 라벨그리고 사용되는 것과 같은 서식.(례:「^!C」 「^Home」 「^NumpadHome」)수식 키는Ctrl(^),Alt(!),Shift(+)마셔 사용 가능.

Related

GUI, Gui,Add