スクリプトの実行中にホットキーを作成、変更、有効化、または無効化します。
Hotkey KeyName , Action, Options
型：文字列
修飾記号を含む、ホットキーの起動キーの名前。例えば、Win+Cのホットキーには#cを指定します。
If KeyName already exists as a hotkey -- either by the Hotkey function or a double-colon label in the script -- that hotkey will be updated with the values of the function's other parameters.
既存のホットキーを指定する場合、KeyNameの大文字と小文字は区別されません。ただし、キーの名前は既存のホットキーと同じスペルでなければなりません（例：この目的ではEscはEscapeと同じではありません）。また、^!+#などの修飾記号の順番は関係ありません。GetKeyNameを使用して、キー名の標準的な綴りを取得することができます。
When a hotkey is first created -- either by the Hotkey function or the double-colon syntax in the script -- its key name and the ordering of its modifier symbols becomes the permanent name of that hotkey as reflected by ThisHotkey. この名前は、ホットキーのすべてのバリエーションで共有され、ホットキー機能が後で異なるシンボル順序でホットキーにアクセスしても変更されることはありません。
ホットキーバリアントがすでに存在する場合、KeyNameがチルダ（~）接頭辞を含むか含まないかによって、その動作が更新されます。
既存のホットキーにユースフック（$）プレフィックスを追加することができます。この接頭辞は、ホットキーのすべてのバリエーションに影響し、削除することはできません。
If omitted and KeyName already exists as a hotkey, its action will not be changed. ホットキーのOptionsのみを変更したい場合に便利です。Otherwise, specify a callback, a hotkey name without trailing colons, or one of the special values listed below.
Specify the function to call (as a new thread) when the hotkey is pressed.
The callback accepts one parameter and can be defined as follows:
MyCallback(HotkeyName) { ...
Although the name you give the parameter does not matter, it is assigned the hotkey name.
You can omit the callback's parameter if the corresponding information is not needed, but in this case an asterisk must be specified, e.g. MyCallback(*).
ダブルコロン構文で定義されたホットキーは、自動的にパラメータ名ThisHotkeyを使用します。Hotkeyには、Hotkeyの機能を伴わない機能名を割り当てることもできます。
Note: If a callback is specified but the hotkey is disabled from a previous use of the Hotkey function, the hotkey will remain disabled. これを防ぐには、「オプション」に「ON」を入れてください。
Specify a hotkey name to use its original function; specifically, the original function of the hotkey variant corresponding to the current HotIf criteria. 通常、ホットキーの機能を変更した後に元の機能に戻すために使用しますが、両方のホットキーが同じHotIf基準を使用している場合に、別のホットキーの機能を割り当てるために使用することもできます。
Specify one of the following special values:
On：ホットキーが有効になります。ホットキーがすでにOnになっている場合は、何もしません。
Off：ホットキーが無効になります。ホットキーがすでにOffになっている場合は、何もしません。
Toggle：ホットキーが反対の状態（有効または無効）に設定されます。
AltTab（その他）：これらは、ここで説明するAlt-Tabの特殊なホットキーアクションです。
型：文字列
A string of zero or more of the following options with optional spaces in between. 事例："On B0"。
On：ホットキーが現在無効になっている場合は、有効にします。
Off：ホットキーが現在有効になっている場合は、無効にします。これは、通常、初期状態では無効な状態のホットキーを作成するために使用されます。
B または B0:Bを指定すると、#MaxThreadsBufferで説明したように、ホットキーをバッファリングします。このタイプのバッファリングを無効にする場合は、B0（Bに数字0）を指定します。
Pn：文字Pの後にホットキーのスレッド優先順位を指定します。ホットキー作成時にPオプションが省略された場合は、0が使用されます。
S または S0：Sを指定すると、ホットキーがサスペンドを免除するようになり、サスペンドをオフにするためにホットキーを使用できるようになります。S0（Sに数字の0）を指定すると、免除が解除され、ホットキーが中断できるようになります。
Tn:MaxThreadsPerHotkeyで説明したように、このホットキーで許可するスレッド数を文字Tの後に続けて指定します。事例：T5。
In（InputLevel）：文字I（またはi）の後にホットキーの入力レベルを指定します。事例：I1。
オプション文字が省略され、ホットキーがすでに存在する場合、それらのオプションは変更されません。しかし、ホットキーがまだ存在しない場合、つまりこの機能によって作成されようとしている場合、オプションは直近で有効だったものがデフォルトとなります。例えば、スクリプトの一番下にある#MaxThreadsBufferのインスタンスが使用されます。MaxThreadsBufferがスクリプトに表示されていない場合は、そのデフォルト設定（この場合はOFF）が使用されます。
パラメータが無効な場合、またはメモリ確保に失敗した場合は例外がスローされます。
ホットキーが無効であったり、作成できなかったりすると、以下のいずれかの例外が発生することがあります：
| エラークラス | .Message | 説明 |
|---|---|---|
| ValueError | 無効なキー名です。 | KeyNameパラメータは、現在のキーボードレイアウト/言語で認識されていない、またはサポートされていない1つまたは複数のキーを指定します。Exception.Extraには、キー名が含まれます。例えば、!Entreの "Entre"。 |
| 未対応のプレフィックスキーです。 | 例えば、WheelDown & Enterのようなホットキーの接頭辞としてマウスホイールを使用することはサポートされていません。Exception.Extraにはプレフィックスキーが含まれています。 |
|
| このAltTabホットキーは、正確に1つの修飾語/接頭辞を持つ必要があります。 | KeyNameパラメータは、AltTabまたはShiftAltTabアクションでの使用には適していません。（最大で）2つのキーの組み合わせが必要です。事例：RControl & RShift::AltTab。Exception.Extraに KeyNameが含まれています。 |
|
| このAltTabホットキーは、どのキー（LまたはR）を指定する必要があります。 | ||
| TargetError | ホットキーが存在しない。 | この関数は、存在しないホットキーを変更しようとしました。Exception.Extraに KeyNameが含まれています。 |
| 存在しないホットキーバリアント（IfWin）。 | この関数は、既存のホットキーの存在しない変種を変更しようとしました。これを解決するには、HotIfを使用して、変更するホットキーの条件と一致するように設定します。Exception.Extraに KeyNameが含まれています。 | |
| Error | ホットキーを最大にします。 | このホットキーを作成すると、スクリプトごとに32762個のホットキーという制限を超えてしまいます（ただし、各ホットキーには無制限のバリエーションがあり、ホットストリングの数には制限がありません）。 |
ヒント：Try-Catch は、ホットキーのバリアントが存在するかどうかをテストするために使用することができます。事例：
try
Hotkey "^!p"
catch TargetError
MsgBox "The hotkey does not exist or it has no variant for the current HotIf criteria."
現在のHotIf設定は、Hotkey機能が動作するホットキーのバリアントを決定します。
アクティブなウィンドウの種類に応じて選択したホットキーやホットストリングを自動的に無効にすることを目的とする場合、Hotkey "^!c", "Off" は通常、WinActive/WinExist（またはその動的対応であるHotIfWinActive/Exist）で#HotIfを使用するより利便性が低くなります。
ダブルコロン構文でホットキーを作成すると、スクリプトの起動時に一括してホットキーを有効にできるため、ホットキー機能を使用するよりもパフォーマンスが向上します（1つずつ有効にするのではありません）。したがって、この機能は、スクリプトの実行が開始されるまでキー名がわからないホットキーだけを作成するために使用するとよいでしょう。例えば、スクリプトのホットキーで様々なアクションを行う場合、INIファイルで設定することが可能です。
スクリプトがサスペンドされている場合、新しく追加/有効になったホットキーも、サスペンドがオフになるまでサスペンドされます（サスペンドセクションで説明したように免除される場合を除く）。
キーボードや マウスのフックは、本機能による変更で正当化される場合、取り付けまたは取り外しが可能です。
ホットキー機能は、自分以外のスクリプトのホットキーを直接有効にしたり無効にしたりすることはできませんが、ほとんどの場合、同じホットキーを作成したり有効にしたりすることで、それらをオーバーライドできます。これがうまくいくかどうかは、さまざまな要因が重なって決まります：1) オーバーライドするホットキーが他のスクリプトのフックホットキーであるかどうか（フックでないホットキーは常にオーバーライド可能）、2) 最も最近起動したスクリプトのホットキーが他のスクリプトのそれよりも一般的に優先されるという事実（したがって、オーバーライドしようとするスクリプトが最も最近起動した場合、そのオーバーライドは常に成功します）、 3) このホットキーを有効または作成することによってキーボードまたはマウスフックを新たにアクティブ化するかどうか（その場合、オーバーライドは必ず成功します）。
スクリプトに少なくとも1つのホットキーが設定されると、そのスクリプトは永続的なものとなり、終了させるにはExitではなくExitAppを使用する必要があります。
A particular hotkey can be created more than once if each definition has different HotIf criteria. これらは、ホットキーバリアントと呼ばれるものです。事例：
HotIfWinActive "ahk_class Notepad" Hotkey "^!c", MyFuncForNotepad HotIfWinActive "ahk_class WordPadClass" Hotkey "^!c", MyFuncForWordPad HotIfWinActive Hotkey "^!c", MyFuncForAllOtherWindows
ホットキーの複数のバリエーションが発火の対象となる場合、最も早く作成されたものだけが発火します。The exception to this is the global variant (the one with no HotIf criteria): It always has the lowest precedence, and thus will fire only if no other variant is eligible.
重複するホットキーを作成する場合、^!+#などの修飾記号の順番は関係ありません。例えば、"^!c "は"!^c "と同じです。ただし、キーは一貫したスペルで表記する必要があります。例えば、Escはこの目的ではEscapeと同じではありません（ただし、ケースは重要ではありません）。最後に、ワイルドカード接頭辞(*)を持つホットキーは、ワイルドカードでないものと全く別物です。例えば、「*F1」と「F1」は、それぞれ独自のバリエーションを持つことになります。
For more information, see HotIf and #HotIf's General Remarks.
ホットキー記号、HotIf、A_ThisHotkey、#MaxThreadsBuffer、#MaxThreadsPerHotkey、Suspend、スレッド、Thread、Critical、Return、Menuオブジェクト、SetTimer
Hotkey "^!z", MyFunc
MyFunc(ThisHotkey)
{
MsgBox "You pressed " ThisHotkey
}
Alt+Wをメモ帳でのみ動作するホットキーとして作成します。
HotIfWinActive "ahk_class Notepad"
Hotkey "!w", ToggleWordWrap ; !w = Alt+W
ToggleWordWrap(ThisHotkey)
{
MenuSelect "A",, "Format", "Word Wrap"
}
プリミティブな3キーの組み合わせのホットキーを登録できるGUIを作成します。
HkGui := Gui()
HkGui.Add("Text", "xm", "Prefix key:")
HkGui.Add("Edit", "yp x100 w100 vPrefix", "Space")
HkGui.Add("Text", "xm", "Suffix hotkey:")
HkGui.Add("Edit", "yp x100 w100 vSuffix", "f & j")
HkGui.Add("Button", "Default", "Register").OnEvent("Click", RegisterHotkey)
HkGui.OnEvent("Close", (*) => ExitApp())
HkGui.OnEvent("Escape", (*) => ExitApp())
HkGui.Show()
RegisterHotkey(*)
{
Saved := HkGui.Submit(false)
HotIf (*) => GetKeyState(Saved.Prefix)
Hotkey Saved.Suffix, (ThisHotkey) => MsgBox(ThisHotkey)
}