变量和表达式

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

Var := MyArray%A_Index% + 100

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

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

x=1
y=1
var1:=++x  ; 结果为 var1=2, x=2
var2:=y++  ; 结果为 var2=1, y=2
++z        ; 空变量单独使用
msgbox % z ; 结果为 z=1

幂. 底数和指数都可以为小数. 如果指数为负数, 即使底数和指数都为整数, 结果也会被格式化为浮点数. 因为 ** 的优先级高于一元负号, 所以 -2**2 的计算过程和 -(2**2) 一样且得到结果 -4. 因此, 要让负号的优先级高于幂运算, 需要把它们包围在括号中, 例如 (-2)**2.

注意: 不支持底数为负数且指数为小数的情况, 例如 (-2)**0.5; 它会产生空字符串. 但 (-2)**2 和 (-2)**2.0 都是支持的. 该运算符用下面的例子来说明:

msgbox % 2**-2     ; 结果为 0.250000
msgbox % 2**(-2)   ; 结果为 0.250000
msgbox % -2**2     ; 结果为 -4
msgbox % -(2**2)   ; 结果为 -4
msgbox % (-2)**2   ; 结果为 4
msgbox % (-2)**2.0 ; 结果为 4.000000
msgbox % (-2)**0.5 ; 结果为空

注意: 与数学上的对应项不同, ** 在 AutoHotkey v1 中是左结合的. 例如, x ** y ** z 计算为 (x ** y) ** z.

一元负号(-): 尽管它和减运算符使用相同的符号, 但一元负号仅应用于单项或子表达式, 如此例中的两次演示: -(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).

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

str := "d"
if (! str ~= "abc"){     	;~ 必须用括号包围才能获得预期的效果 if ! (str ~= "abc")
  Msgbox 无法匹配字母 %str%   	;~ 不会进入这里
} else {
  Msgbox 可以匹配字母 %str%	;~ 出乎意料的结果
}
    

if (!str := "a"){ 	;~ 效果同 if ! (str := "a")
  Msgbox 不正常: %str% 为 false
}else{
  Msgbox 正常: %str% 为 true	;~ 预期的效果
}
    

大于(>), 小于(<), 大于或等于(>=) 和 小于或等于(<=). 如果两个输入都是数字或数字字符串, 则将它们进行数字比较; 否则将按字母顺序对它们进行比较. 仅当 StringCaseSense 打开时, 比较才区分大小写. 另请参阅: Sort

注意: 在 AutoHotkey v1 中, 直接在表达式中使用的带引号字符串(或与带引号的字符串连接的结果) 始终不被认为是数字.

Equal (=), 区分大小写的等于(==) 和 不等于(<> 或 !=). 如果两个输入都是数字或数字字符串时, 则会对其进行数字比较; 否则按字母顺序进行比较. 运算符 != 和 <> 在功能上是完全相同的. 运算符 == 的行为与 = 完全相同, 除了其中一个输入不是数字时, == 总是区分大小写, 而 = 总是不区分大小写(不区分大小写的方法取决于 StringCaseSense). 与之相比, <> 和 != 都遵循 StringCaseSense.

注意: I 在 AutoHotkey v1 中, 直接在表达式中使用的带引号字符串(或与带引号的字符串连接的结果) 始终不被认为是数字.

不推荐: 不推荐在新脚本中使用 <> 运算符. 使用 != 运算符作为代替.

赋值. 对变量的内容进行运算, 然后把结果保存到同一个变量中(但在 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, MyFunc(). 这样的语句按从左到右的顺序执行.

注意: 以逗号(或其他任何运算符) 开始的行会自动附加到前一行的末尾. 另请参阅: 逗号的性能.

[v1.0.46.01+]: 当逗号后紧跟着变量和等号时, 则这个等号会被自动当成赋值(:=). 例如, 后面所有的都是赋值: x:=1, y=2, a=b=c. 新脚本不应该依赖于这种行为, 因为它可能会改变. 该规则只适用于无格式的变量而不是双重引用, 所以下面的内容只有一个赋值: x:=1, %y%=2

括号中包含的任何子表达式. 例如, (3 + 2) * 2 强制 3 + 2 首先计算.

mod()
round()
abs()

%func%()

弃用的: 不推荐使用这个语法. 而应该用 %func%()(对于函数名称和对象) 或 func.Call()(对于函数对象) 替代.

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

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

[AHK_L 60+]: 可变参数函数. Params(参数) 是一个包含数组(对象)的参数值.

[AHK_L 31+]: 成员访问. 得到或设置值或是对象 x 调用方法, 当 y 是一个参数列表时(特别是数组引索或键)或返回方法名的表达式.

[v1.0.97+]: 数组标识符. 如果左方括号前面没有值(或者一个产生值的子表达式), 它被理解为一个数组的开始. 例如, [a, b, c] 等同于 Array(a, b, c)(a, b 和 c 是变量).

查看数组语法和对象语法以获取更多细节.

[v1.0.97+]: 对象标识符. 创建一个对象或关联数组. 例如, x := {a: b} 等同于 x := Object("a", b) 或者 x := Object(), x.a := b. 查看关联数组以获取更多细节.

当前脚本中正在执行的行所在的行号(或其 #Include 文件的行号). 这个行号与 ListLines 显示的一致; 它可以用在报告错误的时候, 例如: MsgBox Could not write to log file (line number %A_LineNumber%).

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

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

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

对于 [v1.1.06] 之前的 ANSI 可执行文件, A_IsUnicode 没有定义; 也就是说, 脚本可以给它赋值, 并且尝试读取它可能会触发 UseUnsetGlobal 警告. 在以后的版本中, 它始终是定义的并且是只读的.

对于 [v1.1.06] 之前的未编译脚本, A_IsCompiled 没有定义; 也就是说, 脚本可以给它赋值, 并且尝试读取它可能会触发 UseUnsetGlobal 警告. 在以后的版本中, 它始终是定义的并且是只读的.

4 位数表示的当前年份(例如 2004). 与 A_Year 含义相同.

注意: 要获取符合您区域设置和语言的格式化时间或日期, 请使用 FormatTime, OutputVar(时间和长日期) 或 FormatTime, OutputVar,, LongDate(获取长格式日期).

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

YYYYMMDDHH24MISS 格式的当前本地时间.

注意: 使用 EnvAdd 和 EnvSub 可以对日期和时间进行计算. 此外, 使用 FormatTime 可以根据您的区域设置或选项来格式化日期和/或时间.

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

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

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

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

Normal: 此事件是由左键单击和键击(↑, →, ↓, ←, Tab, Space, 带下划线的快捷键等) 触发的. 此变量的值还可以用于菜单项和特殊的 Gui 事件, 例如 GuiClose 和 GuiEscape.

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

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

上下文相关值: 要了解详情请参阅 GuiContextMenu, GuiDropFiles, Slider, MonthCal, ListView 和 TreeView.

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

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

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

首次创建热键时(通过 Hotkey 命令或脚本中的双冒号标签), 其键名及其修饰符的顺序成为此热键的固定名称, 由热键的所有变体共享.

当第一次创建热字符串时, 用于创建它的确切文本将成为热字符串的永久名称.

另请参阅: A_ThisLabel

此变量的值与系统环境变量 ComSpec 一样. 常与 Run/RunWait 一起使用. 例如:

C:\Windows\system32\cmd.exe

C:\Users\<UserName>\AppData\Local\Temp

下列字符串中的一个(如果存在): WIN_7 [需要 AHK_L 42+], WIN_8 [需要 v1.1.08+], WIN_8.1 [需要 v1.1.15+], WIN_VISTA, WIN_2003, WIN_XP, WIN_2000.

在 AutoHotKey 的可执行文件或编译后的脚本属性里应用兼容性设置会让操作系统报告不同的版本号, 该版本号由 A_OSVersion 反映.

[v1.1.20+]: 如果系统版本没有被识别成上述版本, 会返回一个"major.minor.build"形式的字符串. 例如, 10.0.14393 为 Windows 10 build 14393, 也称为 1607 版.

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

Program Files 目录(例如 C:\Program Files 或者 C:\Program Files (x86)). 一般来说和 ProgramFiles 环境变量一样.

在 64 位系统(非 32 位系统) 上适用:

• 如果可执行文件(EXE) 以 32 位脚本运行的时候, A_ProgramFiles 返回路径为 "Program Files (x86)" 目录.
• 对于 32 位的进程, ProgramW6432 环境变量指向 64 位 Program Files 目录. 在 Windows 7 和更高版本上, 对于 64 位的进程也是这样设置的.
• 而 ProgramFiles(x86) 环境变量指向 32 位 Program Files 目录.

[1.0.43.08+]: 前缀 A_ 可以省略, 这样有助于自然过渡到 #NoEnv.

当前用户的应用程序数据文件夹的完整路径和名称. 例如:

C:\Users\<UserName>\Application Data

所有用户的应用程序数据文件夹的完整路径和名称. 例如:

C:\ProgramData

当前用户的桌面文件夹的完整路径和名称. 例如:

C:\Users\<UserName>\Desktop

所有用户的桌面文件夹的完整路径和名称. 例如:

C:\Users\Public\Desktop

当前用户的开始菜单文件夹的完整路径和名称. 例如:

C:\Users\<UserName>\AppData\Roaming\Microsoft\Windows\Start Menu

所有用户的开始菜单文件夹的完整路径和名称. 例如:

C:\ProgramData\Microsoft\Windows\Start Menu

当前用户的开始菜单中程序文件夹的完整路径和名称. 例如:

C:\Users\<UserName>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs

所有用户的开始菜单中程序文件夹的完整路径和名称. 例如:

C:\ProgramData\Microsoft\Windows\Start Menu\Programs

当前用户的开始菜单中启动文件夹的完整路径和名称. 例如:

C:\Users\<UserName>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

所有用户的开始菜单中启动文件夹的完整路径和名称. 例如:

C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup

当前用户 "我的文档" 文件夹的完整路径和名称. 与大多数类似变量不同, 当此文件夹为驱动器的根目录时, 此变量的值不包含最后的反斜杠(例如, 它的值是 M: 而不是 M:\). 例如:

C:\Users\<UserName>\Documents

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

要使脚本以管理员权限重新启动(或显示提示向用户请求管理员权限), 请使用 Run *RunAs. 但是请注意, 以管理员权限运行脚本会导致脚本启动的所有程序也以管理员权限运行. 对于可能的替代方案, 请参阅常见问题(FAQ).

A_ScreenWidth
A_ScreenHeight

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

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

要获取整个桌面(即使它横跨多个显示器)的宽度和高度, 请使用下面的例子:

SysGet, VirtualWidth, 78
SysGet, VirtualHeight, 79

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

当前显示的鼠标光标类型. 其值为下列单词的其中一个: AppStarting(程序启动, 后台运行--箭头+等待), Arrow(箭头, 正常选择--标准光标), Cross(十字, 精确选择), Help(帮助, 帮助选择--箭头+问号), IBeam(工字光标, 文本选择--输入), Icon, No(No, 不可用--圆圈加反斜杠), Size, SizeAll(所有尺寸,移动--四向箭头), SizeNESW(东南和西北尺寸, 沿对角线调整 2--双箭头指向东南和西北), SizeNS(南北尺寸, 垂直调整--双箭头指向南北), SizeNWSE(西北和东南尺寸, 沿对角线调整 1--双箭头指向西北和东南), 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

包含 1 和 0. 它们可以用来使脚本更具可读性. 有关详情, 请参阅布尔值.