#HotIf

文脈依存のホットキーと ホットストリングを作成します。このようなホットキーは、任意の条件（式）に応じて異なるアクションを実行します（または全く実行されません）。

#HotIf Expression

パラメータ

Expression

型：論理値

If omitted, subsequently-created hotkeys and hotstrings are not context-sensitive. Otherwise, specify any valid expression. これは、1つのパラメータ（ThisHotkey）を持つ暗黙の関数の戻り値になります。この関数はグローバル変数を直接変更することはできませんが（通常通り想定ローカルであり、宣言を含むことができないため）、グローバル変数を変更する他の関数を呼び出すことができます。

基本操作

#HotIfディレクティブは、その後に作成されるホットキーが起動するかどうかを決定するために使用される式を設定します。この式は、キー、マウスボタン、またはその組み合わせが押されたとき、またはプログラムがホットキーが有効かどうかを知る必要があるその他のときに評価されます。

文脈依存のホットキーや ホットストリングを作るには、単に#HotIfディレクティブを先行させればよい。事例：

#HotIf WinActive("ahk_class Notepad") or WinActive(MyWindowTitle)
#Space::MsgBox "You pressed Win+Spacebar in Notepad or " MyWindowTitle

#HotIf指令は位置指定：#HotIfは、次の#HotIfディレクティブまで、スクリプト内で物理的にその下にあるすべてのホットキーとホットストリングに影響を及ぼします。

注： if文とは異なり、中括弧は#HotIf指示文では効果がありません。

文脈依存性をオフにするには、#HotIfを無表現で指定します。事例：

#HotIf

他のディレクティブと同様に、#HotIfは条件付きで実行することはできません。

マウスやキーボードのホットキーが#HotIfによって無効化されると、本来の機能を発揮します。つまり、そのようなホットキーがないかのように、アクティブウィンドウに通過します。There is one exception: Controller hotkeys: although #HotIf works, it never prevents other programs from seeing the press of a button.

#HotIfは、Enterや Spaceなどの通常のキーの動作を変更するためにも使用できます。これは、特定のウィンドウがそのキーを無視したり、好ましくない動作をする場合に有効です。事例：

#HotIf WinActive("Reminders ahk_class #32770")  ; Outlookの "リマインダー "ウィンドウ。
Enter::Send "!o"  ; Enterキーを押すと、選択したリマインダーをスヌーズするのではなく、開くようにします。
#HotIf

バリアント（複製）ホットキー

特定のホットキーや ホットストリングは、それぞれの定義が異なるHotIf基準であれば、スクリプト内で複数回定義することができます。これらは、ホットキーバリアントと呼ばれるものです。事例：

#HotIf WinActive("ahk_class Notepad")
^!c::MsgBox "You pressed Control+Alt+C in Notepad."
#HotIf WinActive("ahk_class WordPadClass")
^!c::MsgBox "You pressed Control+Alt+C in WordPad."
#HotIf
^!c::MsgBox "You pressed Control+Alt+C in a window other than Notepad/WordPad."

複数のバリアントが発射対象となる場合、スクリプトの先頭に最も近いものだけが発射されます。ただし、グローバルバリアント（HotIfの基準がないもの）については例外です：常に最も低い優先順位を持つので、他の variant が適格でない場合にのみ発火します（この例外はホットストリングには適用されません）。

重複するホットキーを作成する場合、^!+#などの修飾記号の順番は関係ありません。例えば、^!cは!^cと同じです。ただし、キーは一貫したスペルで表記する必要があります。例えば、Escはこの目的ではEscapeと同じではありません（ただし、ケースは重要ではありません）。また、ワイルドカード接頭辞(*)を持つホットキーは、ワイルドカードでないものと全く別物です。例えば、*F1とF1は、それぞれ独自のバリアントセットを持っているでしょう。

ウィンドウグループを使用すると、ウィンドウのグループに対してホットキーを実行させることができます。事例：

GroupAdd "MyGroup", "ahk_class Notepad"
GroupAdd "MyGroup", "ahk_class WordPadClass"

#HotIf WinActive("ahk_group MyGroup")
#z::MsgBox "You pressed Win+Z in either Notepad or WordPad."

ホットキーのバリエーションを動的に（スクリプトの実行中に）作成するには、HotIfを参照してください。

式評価

When the key, mouse or controller button combination which forms a hotkey is pressed, the #HotIf expression is evaluated to determine if the hotkey should activate.

注：スクリプトは、キーが押されたときだけ式が評価されることを想定してはいけません（下記参照）。

この式は、プログラムがホットキーが有効かどうかを知る必要があるときに評価されることもあります。例えば、a & b:: のようなカスタムの組み合わせの #HotIf 式は、プレフィックスキー（この例ではa）が押されたときに評価され、カスタム修飾キーとして機能するかどうかを判断することができます。

注：無反応のスクリプトで#HotIfを使用すると、入力ラグが発生したり、ホットキーが壊れたりすることがあります（下記参照）。

#HotIf指令には、さらにいくつかの注意事項があります：

• キーボードやマウスの入力は、通常、式の評価が完了するかタイムアウトするまでバッファリング（遅延）されます。
• 式の評価は、スクリプトのメインスレッド（OSレベルで、準スレッドではない）でしか行えず、キーボード/マウスフックで直接行うことはできません。FileCopyの実行中など、スクリプトがビジー状態や無反応の場合、式の評価が遅れ、タイムアウトすることがあります。
• システムで定義されたタイムアウトに達すると、キーボードやマウスの入力をスクリプトに通知しなくなる場合があります（詳細は#HotIfTimeoutを参照）。
• 式の評価中にキー操作やマウスクリックを行うと（式が呼び出す関数からなど）、操作が複雑になる可能性があるため、避けてください。

ThisHotkey、A_ThisHotkey、A_TimeSinceThisHotkeyは、現在の#HotIf式が評価されているホットキーに基づき設定されます。

A_PriorHotkey、A_TimeSincePriorHotkeyは、対応する "This"変数の以前の値を一時的に保持します。

最適化

WinActiveや WinExistの単純な呼び出しに対して、#HotIfは式の評価を避けるように最適化されており、そのような場合にラグなどの問題が発生するリスクを低減することができます。具体的：

• この式には、WinExistまたはWinActiveを正確に1回呼び出す必要があります。
• 各パラメータは1つの引用符で囲まれた文字列でなければならず、2つ以上のパラメータを使用することはできない。
• notや !で結果を反転させることができるが、それ以外の演算子は使用できない。
• 空白と括弧は、式がプリコンパイルされるときに完全に処理されるため、この最適化に影響しません。

これらの条件を満たす式は、プログラムによって直接評価され、ListLinesには表示されません。

Hotkey関数を使用して既存のホットキーバリアントを変更する前に、通常、HotIf関数を元の表現テキストで使用する必要があります。ただし、所定の条件の組み合わせを持つ最初のユニークな表現は、その条件によって参照することも可能です。事例：

HotIfWinExist "ahk_class Notepad"
Hotkey "#n", "Off"  ; ホットキーをオフにします。
HotIf 'WinExist("ahk_class Notepad")'
Hotkey "#n", "On"   ; 同じホットキーを再びオンにします。

#HotIf WinExist("ahk_class Notepad")
#n::WinActivate

なお、変数を使用した場合は、表現として失格となる。ホットキー作成後に変数の値が変化しない場合、ラグなど#HotIf特有の問題のリスクを最小化するための戦略が2つあります：

• HotIfWin... MyTitleVarで条件を設定し、Hotkey KeyName, Labelでホットキーのバリアントを作成します。
• 定数式は#HotIf WinActive("ahk_group MyGroup")のようにし、スクリプト内の別の場所でGroupAdd "MyGroup", MyTitleVarでウィンドウグループを定義します。

総論

また、#HotIfは、適切な場合、プレフィックスキーを本来の機能に戻します（プレフィックスキーは、a & bのようなホットキーのAです）。この現象は、指定したプリフィクスに対して有効なホットキーがない場合に発生します。

ホットキーが#HotIfによって現在無効になっている場合、そのキーまたはマウスボタンは、KeyHistoryの「タイプ」列に"#"文字で表示されます。This can help debug a script.

Alt-tabのホットキーは、#HotIfの影響を受けません：これらはすべてのウィンドウで有効です。

Last Found Windowは、#HotIfで設定することができます。事例：

#HotIf WinExist("ahk_class Notepad")
#n::WinActivate  ; WinExist()で見つかったウィンドウをアクティブにします。

関連

#HotIfTimeoutを使用すると、デフォルトのタイムアウト値をオーバーライドすることができます。

Hotkey関数、ホットキー、ホットストリング、Suspend、WinActive、WinExist、SetTitleMatchMode、DetectHiddenWindows

例

#HotIf WinActive("ahk_class Notepad")
^!a::MsgBox "You pressed Ctrl-Alt-A while Notepad is active."
#c::MsgBox "You pressed Win-C while Notepad is active."
::btw::This replacement text for "btw" will occur only in Notepad.
#HotIf
#c::MsgBox "You pressed Win-C in a window other than Notepad."

#HotIf MouseIsOver("ahk_class Shell_TrayWnd")
WheelUp::Send "{Volume_Up}"
WheelDown::Send "{Volume_Down}"

MouseIsOver(WinTitle) {
    MouseGetPos ,, &Win
    return WinExist(WinTitle " ahk_id " Win)
}

#HotIf ActiveControlIsOfClass("Edit")
^BS::Send "^+{Left}{Del}"
^Del::Send "^+{Right}{Del}"

ActiveControlIsOfClass(Cls) {
    FocusedControl := 0
    try FocusedControl := ControlGetFocus("A")
    FocusedControlClass := ""
    try FocusedControlClass := WinGetClass(FocusedControl)
    return (FocusedControlClass=Cls)
}

#HotIf
Esc::ExitApp

NumpadAdd::
{
    static toggle := false
    HotIf 'MouseIsOver("ahk_class Shell_TrayWnd")'
    if (toggle := !toggle)
        Hotkey "WheelUp", DoubleUp
    else
        Hotkey "WheelUp", "WheelUp"
    return
    ; ネストされた機能：	
    DoubleUp(ThisHotkey) => Send("{Volume_Up 2}")
}