#If [AHK_L]

创建上下文相关的热键和热字串。这样的热键会根据表达式的结果执行不同的操作 (或什么都不做).

#If [, Expression ]

参数

Expression

任何有效的 表达式.

基本操作

可以使用任何有效的表达式定义激活热键的上下文. 例如：

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

与 #IfWin 指令一样, #If 是与位置有关的: 它会作用于脚本中实际在它后面的所有热键和热字串. #If 和 #IfWin 也是互斥的; 即只有最近的 #If 或 #IfWin 会起作用.

要关闭上下文相关性, 请指定 #If 或任一 #IfWin 指令但省略所有参数. 例如：

#If

一般说明

当按下的按键组合形成了热键时, #If 表达式的计算结果决定了是否激活热键. 只有在表达式计算完成或超时后系统才会响应键盘或鼠标输入。在计算这个表达式过程中发送键击或鼠标点击（例如来自它所调用的函数）可能导致复杂的情况，应该避免这样做。

由于 AutoHotkey 设计的问题，在单个键盘或鼠标事件时可能会计算这个表达式两次。

由于前面所说的原因，应该把这个表达式设计为尽快结束并且不会产生副作用。

[AHK_L 53+]: A_ThisHotkey 和 A_TimeSinceThisHotkey 包含与当前正在求值的 #If 表达式的热键相关的值.

[v1.0.95.00+]: A_PriorHotkey 和 A_TimeSincePriorHotkey 临时包含了与对应的 "This" 变量包含的前一个值.

相关

大部分 #IfWin 指令的行为属性也适用于 #If.

可以使用 #IfTimeout 覆盖默认的超时时间值.

示例

; 示例 1: 在任务栏上滚动鼠标来调节音量.
#If MouseIsOver("ahk_class Shell_TrayWnd")
WheelUp::Send {Volume_Up}
WheelDown::Send {Volume_Down}

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

; 示例 2: 在所有的编辑控件中的轻松删除单词的快捷键.
#If ActiveControlIsOfClass("Edit")
^BS::Send ^+{Left}{Del}
^Del::Send ^+{Right}{Del}

ActiveControlIsOfClass(Class) {
    ControlGetFocus, FocusedControl, A
    ControlGet, FocusedControlHwnd, Hwnd,, %FocusedControl%, A
    WinGetClass, FocusedControlClass, ahk_id %FocusedControlHwnd%
    return (FocusedControlClass=Class)
}

; 示例 3: 与上下文不相关的热键.
#If
Esc::ExitApp

; 示例 4: 动态热键. 需要示例 1.
NumpadAdd::
Hotkey, If, MouseIsOver("ahk_class Shell_TrayWnd")
if (doubleup := !doubleup)
    Hotkey, WheelUp, DoubleUp
else
    Hotkey, WheelUp, WheelUp
return

DoubleUp:
Send {Volume_Up 2}
return