キーリスト（キーボード、マウス、コントローラ）

目次

• マウス
  • 一般的なボタン
  • 高度なボタン
  • ホイール
• キーボード
  • 一般的なキー
  • カーソル制御キー
  • テンキー
  • ファンクションキー
  • 修飾キー
  • マルチメディア キー
  • その他のキー
• ゲームコントローラー（ゲームパッド、ジョイスティックなど）
• ハンドヘルドリモコン
• 特殊キー
• CapsLock と IME

マウス

一般的なボタン

高度なボタン

ホイール

キーボード

注：文字と数字のキーの名前は、その1文字または数字と同じです。事例：b は B で、5 は 5です。

任意の 1 文字をキー名として使用できますが、その意味（スキャンコードまたは仮想キーコード）は現在のキーボード レイアウトによって異なります。さらに、一部の特殊文字は状況に応じてエスケープするか、中かっこで囲む必要がある場合があります。a-zまたはA-Zの文字は、現在のキーボードレイアウトに含まれていなくても、対応する仮想キーコード（通常はvk41～vk5A）を参照するために使用できます。

一般的なキー

カーソル制御キー

テンキー

システムの動作上、スラッシュで区切られた以下のキーは、NumLockのON/OFFによって識別が異なります。NumLockがOFFの状態でShiftを押すと、一時的にShiftが解除され、NumLockがONであるかのように動作します。

ファンクションキー

修飾キー

マルチメディア キー

以下の各キーに割り当てられている機能は、Windowsのレジストリを変更することで上書きすることができます。この表は、Windowsのほとんどのバージョンで、各キーのデフォルトの機能を示しています。

その他のキー

^VK24::MsgBox "You pressed Home or NumpadHome while holding down Control."

ゲームコントローラー（ゲームパッド、ジョイスティックなど）

注：歴史的な理由から、以下のボタンとコントロールの名前はジョイスティックを意味するJoyで始まります。しかし、通常はゲームパッドやステアリングホイールなど、他のゲームコントローラーにも使用できる。

Joy1からJoy32：コントローラーのボタン。コントローラのボタン番号を決定するには、以下のテストスクリプトを使用します。なお、^（control）、+（shift）などのホットキー接頭記号はサポートしていません（GetKeyStateで代替できます。）。また、コントローラボタンの押下を検出するように設計されているウィンドウでは、コントローラボタンの押下は常にアクティブウィンドウを「通過」することに注意してください。

以下のコントロール名はホットキーとして使用できませんが、GetKeyStateで使用できます：

• JoyX, JoyY, and JoyZ: The X (horizontal), Y (vertical), and Z (altitude/depth) axes of the stick.
• JoyR: The rudder or 4th axis of the stick.
• JoyU and JoyV: The 5th and 6th axes of the stick.
• JoyPOV：視点（帽子）コントロール。
• JoyName：コントローラまたはそのドライバの名前。
• JoyButtons（ジョイボタン）：コントローラがサポートするボタンの数（必ずしも正確ではない）。
• JoyAxes：コントローラがサポートする軸の数。
• JoyInfo：コントローラの能力を示す、以下の文字からなる文字列を提供する：Z（Z軸を持つ）、R（R軸を持つ）、U（U軸を持つ）、V（V軸を持つ）、P（POVコントロールを持つ）、D（POVコントロールは離散的／明確な設定が限られている）、C（POVコントロールは連続／微細である）。例の文字列：ZRUVPD

例えば、Xbox Wireless/360コントローラーを使用する場合、JoyX/JoyYは左スティック、JoyR/JoyUは右スティック、JoyZは左右のトリガー、JoyPOVは方向パッド（Dパッド）となる。

複数のコントローラー：コンピュータに複数のコントローラがあり、最初のコントローラ以外のコントローラを使用する場合は、コントロール名の前にコントローラ番号（最大16）を含めます。例えば、2joy1は2つ目のコントローラーの最初のボタン。

注：スクリプトがコントローラを認識できない場合は、コントローラが1つしかなくても、コントローラ番号を1以外に指定してください。このような状況がどのように発生するのか、または正常かどうかは不明ですが、コントローラのテストスクリプトでコントローラ番号を実験することで、システムに該当するかどうかを判断することができます。

こちらも参照のこと：

• コントローラーのリマッピング：コントローラでキーストロークやマウスクリックを送信する方法。
• Controller-To-Mouse script:コントローラーをマウスとして使う

ハンドヘルドリモコン

WinLIRCクライアントスクリプトにより、手持ちのリモコンからの信号に応答します。

特殊キー

キーボードやマウスに上記以外のキーがある場合でも、以下の手順でホットキーにすることができる場合があります。

1. キーボードフックを使用するスクリプトが少なくとも1つ実行されていることを確認します。スクリプトにキーボードフックがあるかどうかは、スクリプトのメインウィンドウを開き、メニューバーから「表示->キー履歴」を選択することで確認できます。
2. そのスクリプトのトレイアイコンをダブルクリックして、メインウィンドウを開きます。
3. キーボードの「何れかのキー」を押します。
4. メニューの "表示→キー履歴"を選択します。
5. ページ下部までスクロールしてください。下の方に、キーのキーダウンイベントとキーアップイベントがあります。注：一部のキーはイベントが発生しないため、ここでは表示されません。この場合、キーボードドライバーやハードウェアが、AutoHotkeyがアクセスするには低すぎるレベルで扱うため、その特定のキーを直接ホットキーとすることはできません。解決策については、さらに以下をご覧ください。
6. キーが検出可能な場合は、リストの2列目にある3桁の16進数値をメモしてください（例：159）。
7. このキーをホットキーとして定義するには、次の例に従います。

   SC159::MsgBox ThisHotkey " was pressed." ; 159をキーの値で置き換えます。
   

   ThisHotkeyもご覧ください。

逆方向：他のキーを "ミステリー・キー"にリマップするには、次のようにします：

; 159を上記で発見された値で置き換えてください。FFを(必要であれば)以下の値で置き換えます。
; キーヒストリー画面の最初の列で発見できる、 ;キーの仮想キーです。
#c::Send "{vkFFsc159}" ; 詳しくは Send {vkXXscYYY} をご覧ください。

別の解決策:キーまたはマウスボタンが「キー履歴」画面で検出できない場合は、次のいずれかをお試しください：

1. マウスやキーボードに付属のソフトウェア（コントロールパネルやスタートメニューからアクセスできる場合もあります）を再設定して、「いずれかのキー」が他のキーストロークを送信するようにします。このようなキーストロークは、スクリプトのホットキーとして定義することができます。例えば、Ctrl+F1を送信するようにミステリーキーを設定した場合、スクリプトで^F1::を使うことで、間接的にそのキーをホットキーとして使用することができます。

2. AHKHIDを試してみてください。また、RawInput*、，USB HIDまたはAHKHIDなどのキーワードでフォーラムを検索してみるのもよいでしょう。

3. 以下は最終手段であり、一般的には絶望的な場合にのみ試みるべきものです。成功する確率が低く、元に戻すのが困難な望まない副作用を引き起こす可能性があるからです。
   キーボードやマウスに付属している余分なソフトウェアを無効化または削除するか、OSに内蔵されているような標準的なドライバーに変更してください。これは、お使いのキーボードやマウスにそのようなドライバがあり、そのカスタムドライバやソフトウェアが提供する機能なしでいられることを前提としています。

CapsLock と IME

Windows IMEの一部の構成（英語キーボードで日本語入力など）では、CapsLockを使用してモードを切り替えます。このような場合、CapsLockはIMEによって抑制され、AutoHotkeyで検出することができない。ただし、Alt+CapsLock、 Ctrl+CapsLockおよび、Shift+CapsLockのショートカットは、回避策で無効にすることができます。具体的には、キーアップを送信してIMEの状態を変更するが、キーボードフックに信号を送ってイベントを抑制することで、他の影響を防ぐことができる。その際、以下の機能を利用することができます。

; キーボードフックの取り付けが必要です。
InstallKeybdHook
SendSuppressedKeyUp(key) {
    DllCall("keybd_event"
        , "char", GetKeyVK(key)
        , "char", GetKeySC(key)
        , "uint", KEYEVENTF_KEYUP := 0x2
        , "uptr", KEY_BLOCK_THIS := 0xFFC3D450)
}

この関数をスクリプトにコピーするか、LibフォルダにSendSuppressedKeyUp.ahkとして保存し、スクリプトに#Include <SendSuppressedKeyUp>を追加すると、次のように使えるようになります。

; IME の Alt+key ショートカットを無効にします。
~LAlt::SendSuppressedKeyUp "LAlt"

; ホットキーのテスト。
!CapsLock::MsgBox A_ThisHotkey

; IMEと互換性のある方法で、CapsLockをLCtrlにリマップします。
*CapsLock::
{
    Send "{Blind}{LCtrl DownR}"
    SendSuppressedKeyUp "LCtrl"
}
*CapsLock up::
{
    Send "{Blind}{LCtrl Up}"
}