变量和表达式

如果表达式中的变量包围在百分号中 (例如 %Var%), 不管此变量 包含 什么内容都会被假定为另一个变量 (如果不存在这样的变量, 那么 %Var% 会被解析为空字符串) 的名称或部分名称. 这种方法常用来引用 伪数组 元素, 例如:

Var := MyArray%A_Index% + 100

为了向后兼容, 注明了 "可以使用表达式" 的命令参数把百分号中的孤立名称 (例如 %Var%, 但不是 Array%i%) 当作其两边的百分号不存在一样. 通过把引号包围在括号中可以避免这种情况；例如 Sleep (%Var%)。

[AHK_L 52+]: 除了普通变量, %Var% 还可以解析为 环境变量, 剪贴板或任何的 保留/只读的变量. 在修订号 52 之前, 在这些情况中 %Var% 会被当成空字符串.

一元负号（-）：尽管它和减运算符使用相同的符号，但一元负号仅应用于单项或子表达式，如此例中的两次演示：-(3 / -x)。相关提示, 表达式中的任何一元正号 (+) 都会被忽略.

逻辑非(!): 如果运算数为空或 0, 那么逻辑非的结果为 1, 这表示 "真". 否则, 结果为 0 (假). 例如：!x or !(y and z)。注意: 单词 NOT 和 ! 含义相同, 但 ! 优先级更高. 在 v1.0.46+，允许使用连续的一元运算符，例如 !!Var，因为它们是按从右到左的顺序计算。

按位非 (~): 此运算符对运算数按位取反. 如果运算数为浮点数, 则在计算前把它截取成整数. 如果运算数介于 0 和 4294967295 (0xffffffff) 之间, 那么它会被视为 无符号的 32 位值. 否则, 它被视为 有符号的 64 位值. 例如，~0xf0f 计算结果为 0xfffff0f0（4294963440）。

取址（&）：&MyVar 获取 MyVar 的内容的内存地址，此地址一般和 DllCall 结构一起使用。同时 &MyVar 也禁用了此变量中的二进制数的缓存，如果它经常用于数学或数值比较，那么这会拖慢其性能。每当变量的地址改变时会重新启用它的缓存 (例如使用 VarSetCapacity()).

解除引用（*）：*Expression 假定 Expression 解析为数值的内存地址；它会获取在一个介于 0 和 255 之间的数字表示的内存地址中一个字节的内容（地址为 0 时获取的结果也总是 0；但应该避免使用其他任何无效地址，因为它可能会让脚本崩溃）。然而, 使用 NumGet() 获取二进制数通常会更好.

乘 (*): 如果两个输入都为整数, 则结果为整数; 否则结果为浮点数.

真除 (/): 与 EnvDiv 不同, 即使两个输入都是整数, 真除的结果也为浮点数. 例如，3/2 结果为 1.5 而不是 1，而 4/2 结果为 2.0 而不是 2。

向下舍除 (//): 如果两个输入都是整数, 那么双斜线运算符使用高效的整数除法. 例如，5//3 结果为 1 而 5//-3 结果为 -1。如果任何一个输入为浮点数, 则执行浮点除法并把结果往下取整到最近的整数. 例如，5//3.0 结果为 1.0 而 5.0//-3 结果为 -2.0。尽管浮点除法的结果为整数, 但它被保存为浮点格式, 以便其他使用者能使用浮点格式. 关于求模运算，请参阅 mod()。

*= 和 /= 运算符是用变量的值乘以或除以另一个值的一种简写形式. 例如，Var*=2 和 Var:=Var*2 会得到相同的结果（不过前者执行的更好）。

除数为零时结果为空 (空字符串).

加 (+) 和 减 (-). 相关提示, += 和 -= 运算符是从变量中增加或减少值的一种简写形式. 例如，Var+=2 和 Var:=Var+2 会得到相同的结果（不过前者执行的更好）。同样地，使用 Var++、Var--、++Var 或 --Var 可以让变量增加或减小 1。

连接. 句点运算符用于把两个项目组合成单个字符串 (在句点的两边至少必须有一个空格). 省略句点也可以达到相同的目的（除非表达式中有不明确的关系，例如 x -y，或在右边的项目含有前导的 ++ 或 -- 运算符）。省略句点时, 合并的两个项目间应该至少有一个空格.
示例（表达式方法）：Var := "The color is " . FoundColor
示例（传统方法）：Var = The color is %FoundColor%

还可以用来连接子表达式. 例如：Var := "The net price is " . Price * (1 - Discount/100)。

以句点 (或其他任何运算符) 开始的行会自动 附加到 前一行的末尾.

赋值. 对变量的内容进行运算, 然后把结果保存到同一个变量中 (但在 1.0.46 之前的版本中, 这些运算符只能在一行中最左边使用, 且仅支持前五个运算符). 最简单的赋值运算符为 冒号等号 (:=), 它把表达式的结果保存到变量中. 关于其他运算符的功能说明, 请参阅这个表格中它们的相关条目. 例如，Var //= 2 执行向下舍除，把 Var 除以 2，然后把结果保存回 Var。同样地，Var .= "abc" 为 Var := Var . "abc" 的一种简写形式。

与其他大多数运算符不同, 赋值运算是从右往左执行的. 因此，Var1 := Var2 := 0 这个语句中首先把 0 赋值给 Var2，然后把 Var2 赋值给 Var1。

如果使用赋值运算的结果作为其他某些运算符的输出, 那么输入的值是变量自身. 例如，如果变量 Var 新增值后大于 50，那么表达式 (Var+=2) > 50 结果为真。这样还允许赋值被作为 ByRef 传递或获取它的地址，例如：&(x:="abc")。

需要避免语法错误或提供更直观的操作时, 会自动提升赋值运算符的优先级. 例如：not x:=y 等价于 not (x:=y)。同样地，++Var := X 等价于 ++(Var := X)；而 Z>0 ? X:=2 : Y:=2 等价于 Z>0 ? (X:=2) : (Y:=2)。

由向后兼容引起的已知限制（可能会在未来的版本中解决）：1) 当 /= 为表达式中最左边的运算符并且它不是多语句表达式的一部分时，而且输入都不是浮点数时，它会执行向下舍除（在其他所有情况中，/= 会执行真除）；2) 仅当 += 和 -= 为一行中最左边的运算符时，它们才支持日期/时间的计算；3) 运算符 +=, -= 和 *= 仅在空变量在单独一行时才把它们视为零；例如，y:=1, x+=1 和 MsgBox % x-=3 当 x 为空时都得到空的结果。

逗号 (多语句) [v1.0.46+]. 逗号可以用来在单行中书写多个子表达式. 最常用于把多个赋值或函数调用聚集在一起. 例如：x:=1, y+=2, ++index, func()。这样的语句按从左到右的顺序执行. 注意: 以逗号 (或其他任何运算符) 开始的行会自动 附加到 前一行的末尾. 另请参阅: 逗号的性能.

在 v1.0.46.01+, 当逗号后紧跟着变量和等号时, 则这个等号会被自动当成赋值 赋值 (:=). 例如，后面所有的都是赋值：x:=1, y=2, a=b=c。

mod()
round()
abs()

[AHK_L 48+]: 试图调用对象 func 的命名的空方法. 按照约定, 这是对象的 "默认" 方法. 如果 func 不是对象, 则调用 默认基对象.

[v1.0.95+]: 如果 func 为函数名, 则调用这个命名的函数.

当前脚本中正在执行的行所在的行号 (或其 "ListLines.htm">ListLines 显示的一致；它可以用在报告错误的时候，例如：MsgBox Could not write to log file (line number %A_LineNumber%)。

由于 已编译脚本 已经把它所有的 #Include 文件 合并成一个大脚本, 所以它的行号可能与它在未编译模式运行时不一样.

对于未编译脚本: 实际运行当前脚本的 EXE 文件的完整路径和名称. 例如: C:\Program Files\AutoHotkey\AutoHotkey.exe

对于 已编译脚本: 除了通过注册表条目 HKEY_LOCAL_MACHINE\SOFTWARE\AutoHotkey\InstallDir 获取 AutoHotkey 目录外, 其他的和上面相同. 如果找不到这个注册表条目, 则 A_AhkPath 为空.

2 位数表示的当前分钟数 (00-59).

计算机重启后经过的毫秒数. 通过把 A_TickCount 保存到变量中, 经过一段时间后从最近的 A_TickCount 值中减去那个变量, 可以计算出所经过的时间. 例如：

StartTime := A_TickCount
Sleep, 1000
ElapsedTime := A_TickCount - StartTime
MsgBox,  %ElapsedTime% milliseconds have elapsed.

如果您需要比 A_TickCount 的10ms 更高的精确度, 请使用 QueryPerformanceCounter().

与上面类似, 但在安装了相应的钩子 (键盘 或 鼠标) 后会忽略模拟的键击和/或鼠标点击; 即此变量仅反应物理事件. (这样避免了由于模拟键击和鼠标点击而误以为用户存在.) 如果两种钩子都没有安装, 则此变量等同于 A_TimeIdle. 如果仅安装了一种钩子, 那么仅此类型的物理输入才会对 A_TimeIdlePhysical 起作用 (另一种/未安装钩子的输入, 包括物理的和模拟的, 都会被忽略).

启动当前线程的事件类型。如果当前线程不是由 GUI 动作 启动的，则此变量为空。否则, 它为下列字符串的其中一个:

Normal: 此事件是由左键单击和键击 (方向键, TAB 键, 空格键, 带下划线的快捷键等) 触发的. 此变量的值还可以用于菜单项和特殊的 Gui 事件, 例如 GuiClose 和 GuiEscape.

DoubleClick: 此事件是由双击触发的. 注意: 双击中的首次点击仍会引起 Normal 事件首先被接收到. 换句话说, 双击时子程序会运行两次: 一次在首次点击时, 再次是在第二次点击时.

RightClick: 仅出现在 GuiContextMenu, ListViews 和 TreeViews.

上下文相关值：要了解详情请参阅 GuiContextMenu、GuiDropFiles、Slider、MonthCal、ListView 和 TreeView。

包含下列事件的额外信息:

• OnClipboardChange 标签
• 鼠标滚轮热键 (WheelDown/Up/Left/Right)
• RegisterCallback()
• GUI 事件, 即 GuiContextMenu, GuiDropFiles, ListBox, ListView, TreeView 和 StatusBar. 如果一个事件没有额外的信息, 那么 A_EventInfo 的值为 0.

最近执行的 热键 或 非自动替换热字串 的按键名称 (如果没有则为空), 例如 "https://www.xnip.cn/doc/AutoHotkey-Threads">当前线程 被其他热键中断, 那么此变量的值会变化, 所以如果之后需要在子程序中使用原来的值, 则必须马上把它复制到另一个变量中.

首次创建热键时 (通过 Hotkey 命令 或 双冒号标签 ), 其键名以及修饰符的顺序成为此热键的固定名称. 另请参阅: A_ThisLabel

下列字符串的其中一个：WIN_7 [需要 v1.1+ 或 AHK_L]、WIN_8 [需要 v1.1.08+]、WIN_8.1 [需要 v1.1.15+]、WIN_VISTA、WIN_2003、WIN_XP、WIN_2000。

; 这个示例已过时了，里面的这些操作系统都不再受支持。
if A_OSVersion in WIN_NT4,WIN_95,WIN_98,WIN_ME  ; 注：逗号两边没有空格。
{
    MsgBox This script requires Windows 2000/XP or later.
    ExitApp
}

如果当前用户有管理员权限, 则此变量的值为 1. 否则为 0.

在 Windows Vista 或更高版本中, 一些脚本可能需要管理员权限才能正常运行 (例如与使用管理员权限执行的进程和窗口进行交互的脚本). 要做到这点，请把下列语句添加到脚本的顶部：

if not A_IsAdmin
{
   Run *RunAs "%A_ScriptFullPath%"  ; 需要 v1.0.92.01+
   ExitApp
}

A_ScreenWidth
A_ScreenHeight

主监视器的宽度和高度, 单位为像素 (例如 1024 和 768).

要获取多显示器系统中其他显示器的尺寸, 请使用 SysGet.

要获取整个桌面（即使它横跨多个显示器）的宽度和高度，请使用下面的例子：

SysGet, VirtualWidth, 78
SysGet, VirtualHeight, 79

此外, 使用 SysGet 可以获取显示器的工作区域, 它比显示器的整个区域小, 因为它不包括任务栏和其他注册的桌面工具栏.

当前显示的鼠标光标类型. 其值为下列单词的其中一个: AppStarting, Arrow, Cross, Help, IBeam, Icon, No, Size, SizeAll, SizeNESW, SizeNS, SizeNWSE, SizeWE, UpArrow, Wait, Unknown. 与 size 指针类型一起的首字母表示方向, 例如 NESW = NorthEast+SouthWest. 手型指针 (点击和抓取) 属于 Unknown 类别.

当前光标 (文本插入点) 的 X 和 Y 坐标. 如果没有使用 CoordMode 使得坐标相对于整个屏幕, 默认坐标相对于活动窗口. 如果没有活动窗口或无法确定文本插入点的位置, 则这两个变量为空.

下面这个脚本可以让您在四处移动文本插入点时, 查看显示在自动更新工具提示上的当前位置. 注意在某些窗口 (例如某些版本的 MS Word) 会不管文本插入点的实际位置如何都报告同样的位置.

#Persistent
SetTimer, WatchCaret, 100
return
WatchCaret:
  ToolTip, X%A_CaretX% Y%A_CaretY%, A_CaretX, A_CaretY - 20
return

如果以很高的频率 (即每 500 ms 或更快) 重复获取这些变量的内容, 那么可能会干扰用户双击鼠标. 没有已知的解决方法.