2.10AutoHotkey 中标签和函数

作者:河许人 2024年4月1日,第8次修订

在AutoHotkey编程中,标签(Label)和函数(Function)是两种重要的代码复用工具。它们的存在使得程序员能够更有效地组织和管理代码,提高代码的可读性和可维护性。尽管它们都是为了实现代码复用的目的,但标签和函数在使用方式和特性上有所不同,每种工具都有其独特的优势。

一、标签

标签比较简单,用来标记一段代码的位置。

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

Test 就是一个标签。标签可以用 Gosub 调用,Gosub 执行完后会继续执行下一行。也可以用 Goto 调用,但 Goto 调用完就不会回来了。

除了使用 Gosub 或者 Goto 调用,标签还可以作为其他命令的参数,比如 Hotkey、SetTimer 等等。

标签里的代码默认是执行的。比如这样一个 AHK 文件。

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

即使没有主动调用 Test 标签,Test 标签里的内容还是会被执行。

可以使用动态的标签名来调用标签。

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

二、函数

函数是一种更为强大和结构化的代码复用工具。它们可以接受参数并返回结果,使得代码更加模块化和可重用。AutoHotkey v2.0相对AutoHotkey v1.1有了很大发展,也更加完善,为了避免误解,本节以AutoHotkey v2.0的知识作为主要内容。

(一)介绍和简单示例

函数是可以通过 调用 来执行的可重用代码块. 函数可以选择接受参数(输入) 并返回值(输出). 参考下面的简单函数, 其接受两个数字并返回它们的和:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

上面就是一个函数的 定义, 因为它创建了一个名称为 “Add”(不区分大小写) 的函数, 并且确立了调用它时必须准确的提供两个参数(x 和 y). 要调用此函数, 把它的结果通过 := 运算符赋值给变量. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

当然, 函数调用时也可以不保存其返回值:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

不过这种情况下, 函数的任何返回值都会被丢弃; 所以除非函数还有除了返回值之外的功能, 否则这次调用毫无意义.

在表达式中, 函数调用 “计算出” 函数的返回值. 可以将返回值赋给如上所示的变量, 也可以像下面一样地直接使用:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

(二)参数

定义函数时, 函数的参数都在其名称后的括号中列出(函数名和左括号之间不能有空格). 如果函数不接受任何参数, 请把括号内留空; 例如: GetCurrentTimestamp().

已知限制:

  • 如果一个参数在函数调用中被解析为一个变量(例如 Var 或 ++Var 或 Var*=2), 它左边或右边的其他参数可能在它被传递给函数前修改这个变量. 例如, 当 Var 初始为 0 时 MyFunc(Var, Var++) 会意外地传递 1 和 0, 因为在函数调用执行之前, 第一个 Var 不会被解引用. 因为这种行为是违反常规的, 所以可能在将来的版本中改变.

ByRef 参数

从函数的角度看, 参数本质上是局部变量, 除非它们被定义为 ByRef 如下例所示:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

在上面的例子中, 使用 & 需要调用者传递一个 VarRef, 它通常对应于调用者的一个变量. 每个参数都成为 VarRef 所代表的变量的别名. 换句话说, 参数和调用者的变量都引用内存中相同的内容. 这样使得 Swap 函数可以通过移动 Left 的内容到 Right 中来改变调用者的变量, 反之亦然.

与之相比, 如果在上面的例子中没有使用 ByRef, 那么 Left 和 Right 将是调用者变量的副本, 因此 Swap 函数不会对外部产生任何影响. 然而, 函数可以改为显式地解引用每个 VarRef. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

由于 return 只能返回一个值给函数的调用者, 所以可以使用 VarRef 返回更多的结果. 这是通过函数将调用者传递进来的变量的引用(通常为空值的) 赋值实现的.

传递大字符串给函数时, 使用 ByRef 提高了性能, 并且通过避免生成字符串的副本节约了内存. 同样地, 使用 ByRef 送回长字符串给调用者通常比类似 Return HugeString 的方式执行的更好. 然而, 函数接收到的不是对字符串的引用, 而是对 变量 的引用. 未来的改进可能会取代 ByRef 在这些方面的使用.

已知限制:

  • 不能将对象的属性(如 foo.bar), A_Clipboard(剪贴板) 或任何其他内置变量构造成一个 VarRef. 所以这些不能作为 ByRef 传递给函数.
  • 如果参数是可选的, 则无法确定参数引用的变量是新创建的局部变量还是调用者提供的变量. 一种替代方法是使用非 ByRef 参数, 但传递给它一个 VarRef, 并让函数显式地解引用它或将其传递给另一个函数的 ByRef 参数(不使用 & 操作符).

(三)可选参数

在定义函数时, 可以把它的一个或多个参数标记为可选的.

在参数后追加 := 后跟文本的数字, 加引号的/原义的字符串, 如 “fox” 或 “”, 或一个表达式, 该表达式应该在每次需要初始化参数时使用其默认值. 例如, X:=[] 每次都会创建一个新的 Array(数组).

附加 ? 或 := unset 来定义一个默认未设置的参数.

下面这个函数中的 Z 参数就是一个可选参数:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

当调用者传递 三个 参数给上面的函数时, Z 的默认值被忽略. 但当调用者仅传递 两个 参数时, Z 自动接受默认值 0.

可选参数不能孤立地放在参数列表的中间. 换句话说, 在首个可选参数右边的所有参数都必须定义为可选的. 然而, 调用函数时可以省略参数列表中间的可选参数, 如下所示:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

ByRef 参数也支持默认值; 例如: MyFunc(&p1 := ""). 每当调用者省略这样的参数时, 函数会创建一个包含默认值的局部变量; 换句话说, 此时函数的行为就与 “&” 符号不存在时一样.

(四)Unset 参数

要将参数标记为可选而不提供默认值, 请使用关键字 unset 或 ? 后缀. 在这种情况下, 只要省略了参数, 相应的变量就没有值. 请使用 IsSet 来确定参数是否被赋值, 如下所示:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

当参数值为空时, 试图读取参数值将被视为错误, 这与任何未初始化变量一样. 即使参数没有值, 也要将可选参数传递给另一个函数, 可以使用 maybe 操作符(var?). 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

(五)返回值给调用者

如介绍中所说, 函数可以返回一个值给调用者.

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

如果要从函数中返回额外的结果, 可以使用 ByRef (&):

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

可以使用对象和数组返回多个值, 甚至是已命名的值:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

(六)可变参数函数

定义函数时, 在最后一个参数后面写一个星号(*) 来标记此函数为可变参数的, 这样让它可以接收可变数目的参数:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

调用可变参数函数时, 通过保存在函数的最后参数中的对象可以访问剩余的参数. 函数的首个超出参数是 params[1], 第二个是 params[2], 以此类推. 因其是一个数组, params.Length 能被用于确定参数的数目.

尝试使用多于其接受的参数的方式来调用非可变参数函数被认为是错误的. 要允许函数接受任意数量的参数, 而 不 创建数组来存储多余的参数, 请将 * 写入最后一个参数(没有参数名).

注意: “可变” 参数只可以出现在显式参数(形参) 列表的末尾.

(七)可变参数函数的调用

虽然可变参数函数可以 接受 可变数目的参数, 不过在函数调用中使用相同的语法可以把数组作为参数传递给 任何 函数:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

注意:

  • 该对象可以是一个数组, 任何其他类型的可枚举对象(任何带有 __Enum 方法的对象) 或枚举器. 如果对象不是一个数组, 那么每次调用 __Enum 计数为 1, 每次调用枚举器仅使用一个参数.
  • 没有值的数组元素(如 [,2] 中的第一个元素) 相当于省略了参数; 也就是说, 如果参数是可选的, 则使用它的默认值, 否则将抛出异常.
  • 当直接调用用户定义的函数时, 对象可以通过名称与函数参数相同的属性来提供参数值. 但是, 如上所述, 对象必须是可枚举的, 但枚举器(可以是对象本身) 可以返回零项. 位置参数优先于属性, 未使用的属性将被忽略. 调用方法或内置函数时, 不支持命名参数.
  • 这样的语法还可以用于调用对象的方法或检索对象的属性; 例如, Object.Property[Params*].

已知限制:

  • 只有最右边的那个参数才可以这样展开. 例如, 支持 MyFunc(x, y*), 但不支持 MyFunc(x*, y).
  • 在星号(*) 和结束参数列表的符号之间不能存在任何的非空白字符.
  • 函数调用语句不能是可变参数的; 也就是说, 参数列表必须用小括号括起来(或者属性用方括号括起来).

(八)局部和全局变量

1.局部变量

局部变量是特定于单个函数的, 只在该函数内可见. 因此, 局部变量可能与全局变量具有相同的名称, 但有不同的内容. 不同的函数也可以安全地使用相同的变量名.

当函数返回值时, 所有非静态的局部变量都自动释放(变为空), 除了绑定到闭包或 VarRef(这样的变量在闭包或 VarRef 释放时被释放) 的变量.

像 A_Clipboard 和 A_TimeIdle 这样的内置变量永远不会是局部的(它们可以从任何地方访问), 并且不能被重新声明. (这不适用于内置类, 如 Object; 它们被预定义为全局变量.)

默认情况下, 函数是假定-局部的. 在假定-局部函数内访问或创建的变量默认为局部的, 但以下情况除外:

  • 全局变量只能被函数读取, 不能被赋值或使用引用运算符(&).
  • 嵌套函数可以引用由闭合它的函数创建的局部或静态变量.

默认值也可以被覆盖, 通过使用 local 关键字来声明变量, 或者通过改变函数的模式来覆盖(如下所示).

2.全局变量

假定-局部函数中的任何变量引用, 如果只是读取的话, 可以解析为全局变量. 然而, 如果一个变量在赋值中使用或使用引用操作符(&), 它默认是自动局部的. 这就允许函数读取全局变量或调用全局或内置函数, 而无需在函数内部声明, 同时当被赋值的局部变量的名称与全局变量的名称重合时, 可以保护脚本免受意外的副作用. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

否则, 如果要在函数中引用一个现有的全局变量(或者创建一个新的变量), 在使用它之前先声明这个变量为全局变量. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

3.假定-全局模式: 如果函数需要访问或创建大量的全局变量, 通过在函数的首行使用单词 “global”, 从而假定其所有变量都是全局的(参数除外). 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

4.静态变量

静态变量总是隐式的局部变量, 但和局部变量的区别是它们的值在多次调用期间是记住的. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

静态变量可以在声明的同一行初始化, 方法是在它后面跟 := 和任意表达式. 例如: static X:=0, Y:="fox". 静态声明的计算与 local 声明相同, 只是在静态初始化器(或组合初始化器组) 被成功计算后, 它将有效地从控制流中移除, 并且不会再执行第二次.

可以将套嵌函数声明为静态, 以阻止他们捕获外部函数的非静态局部变量.

5.假定-静态模式: 函数的第一行是单词 “static”, 将函数定义为假定-静态模式, 假定其所有未声明变量都是静态的(参数除外). 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

在假定-静态模式中, 任何非静态变量都必须声明为局部或全局变量(与假定-局部模式的例外情况相同.)

6.关于局部和全局变量的更多信息

如下面的例子所示, 通过逗号分隔, 可以在同一行声明多个变量:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

通过在变量后面赋值, 变量可以在声明的同一行进行初始化. 与静态变量初始化不同, 局部和全局变量的初始化在每次调用函数时都执行. 换句话说, 像 local x := 0 和写成单独的两行的效果是一样的: local x 后面跟着 x := 0. 局部和全局初始化允许使用任何赋值运算符, 但是像 global HitCount += 1 这样的复合赋值需要变量之前已经被赋值.

因为单词 local, global 和 static 都是在脚本运行时立即处理的, 所以不能使用 If 语句有条件地声明变量. 换句话说, If 或 Else 的区块内的声明无条件对声明和函数的闭括号之间的所有行生效(但声明中包含的任何初始化仍然是有条件的). 像 global Array%i% 这样的动态声明是不可能的, 因为所有对 Array1 或 Array99 这样的变量的非动态引用都已经被解析为地址了.

(九)动态调用函数

虽然函数调用表达式通常以原义的函数名称开头, 但调用的目标可以是任何产生函数对象的表达式. 在表达式 GetKeyState("Shift") 中, GetKeyState 实际上是一个变量引用, 尽管它通常指的是一个包含内置函数的只读变量.

如果一个函数调用的目标是在脚本运行时确定的, 而不是在脚本启动前确定的, 那么这个函数调用就被称为是 动态的. 与普通函数调用的语法相同; 唯一明显的区别是, 对于非动态调用, 某些错误检查在加载时进行, 而对于动态调用, 只有在运行时才进行.

例如, MyFunc() 将调用 MyFunc 包含的函数对象 , 它可以是一个函数的实际名称, 也可以只是一个被赋值到函数的变量.

其他表达式也可以作为函数调用的目标, 包括双重解引. 例如, MyArray[1]() 将调用 MyArray 的第一个元素所包含的函数, 而 %MyVar%() 将调用变量, 其 名称 包含在 MyVar 中. 换句话说, 首先对参数列表前面的表达式进行计算, 得到函数对象, 然后调用该对象.

如果目标值不是可以被调用的类型, 则抛出 Error:

  • 如果目标值不是可以被调用的类型, 则抛出 MethodError. 任何带有 Call 方法的值都可以被调用, 所以可以使用 HasMethod(value, "Call") 或 HasMethod(value) 来避免这个错误.
  • 传递过少或太多的参数, 这通常可以直接或通过调用 HasMethod(value,, N) 来检查函数的 MinParams, MaxParams 和 IsVariadic 属性来避免, 其中 N 是将传递给函数的参数的数量.
  • 传递变量引用(VarRef) 以外的东西给 ByRef 或 OutputVar 参数, 这可以通过使用 IsByRef 方法来避免.

在调用函数之前, 函数的调用者一般应该知道每个参数的含义以及有多少个参数. 但是, 对于动态调用来说, 函数通常是为了适应函数调用而编写的, 在这种情况下, 失败的原因可能是函数定义的错误而不是参数值的错误.

(十)短路型布尔值的计算

当在表达式中使用 AND, OR 和三元运算符时, 它们会短路以提高性能(无论当前是否存在函数调用). 短路操作是通过不计算表达式中那些不影响最终结果的部分来进行优化运算. (译者注: 只要碰到了 true 或者等价于 true 的就短路, 只要短路了就不会继续往后执行了, 碰到 false 就短路的情况也是同样.) 为了说明这个概念, 请看这个例子:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

在上面的例子中, 如果 ColorName 变量为空, 则永远不会调用 FindColor() 函数. 这是由于 AND 的左侧结果为 false, 因此其右边不可能让最终的结果为 true.

由于此特性, 所以需要注意到, 如果在 AND 或 OR 的右侧调用函数, 那么该函数产生的任何副作用(例如改变全局变量的内容) 可能永远不会发生.

还需要注意在嵌套的 AND 和 OR 串联表达式的求值短路. 例如, 在下面的表达式中每当 ColorName 为空时, 只会进行最左边的比较. 这是因为此时最左边的比较已经足以确定最终的结果:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

从上面的例子可以看出, 任何耗时的函数一般应该在 AND 或 OR 的右侧调用从而提高性能. 这种技术也可以用来防止一个函数在它的一个参数会被传递一个它认为不合适的值(如空字符串) 时被调用.

三元条件运算符(?:) 也通过不计算丢弃的分支来实现短路.

(十一)嵌套函数(注意:AutoHotkey v1.1版本不可以嵌套函数,所以本节以下内容不适合v1.1版本)

嵌套 函数是在另一个函数中定义的函数. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

嵌套函数不能在直接包含它的函数外部通过名称访问, 但是可以在该函数内部的任何地方访问, 包括在其他嵌套函数内部(有例外).

默认情况下, 嵌套函数可以访问包围它的函数中的任何静态变量, 甚至是动态变量. 但是, 如果外部函数既没有声明也没有非动态赋值, 那么嵌套函数内部的非动态赋值通常会解析为局部变量.

默认情况下, 当满足以下要求时, 嵌套函数会自动 “捕获” 外部函数的非静态局部变量:

  1. 外部(outer) 函数必须以下列至少一种方式引用这个变量:
    1. 通过用 local 声明它, 作为一个参数, 或套嵌函数.
    2. 作为赋值或引用操作符(&) 的非动态目标.
  2. 内部(inner) 函数(或嵌套在其内部的函数) 必须非动态地引用变量.

捕获了变量的嵌套函数称为 closure(闭包).

外部函数的非静态局部变量不能被动态访问, 除非它们已经被捕获.

显式声明总是优先于包围它们的函数中的局部变量. 例如, local x 声明了一个当前函数的局部变量, 与外部函数中的任何 x 无关. 外部函数中的全局声明也会影响嵌套函数, 除非被显式声明覆盖.

如果函数声明为假定-全局, 那么在该函数 之外 创建的任何局部或静态变量都不能被该函数本身或其任何嵌套函数直接访问. 相比之下, 假定静态的嵌套函数仍然可以引用外部函数中的变量, 除非函数被声明为静态.

默认情况下, 函数是假定-局部的, 其嵌套函数也是如此, 即使是假定-静态函数中的函数也是如此. 但是, 如果外部函数是假定-全局, 那么嵌套函数默认情况下表现为假定-全局, 除非它们可以引用外部函数的局部和静态变量.

每个函数定义都创建一个包含函数本身的只读变量; 也就是说, 创建一个 Func 或闭包对象. 请参阅下面的例子来了解如何使用这个方法.

(十二)静态函数

任何嵌套函数不捕获变量的都是自动静态的; 也就是说, 对外部函数的每次调用都引用同一个 Func. 关键字 static 可用于显式声明嵌套函数为静态, 在这种情况下, 外部函数的任何非静态局部变量都会被忽略. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

静态函数不能引用自身函数体之外的其他嵌套函数, 除非显式声明为静态. 注意, 即使函数是假定静态的, 非静态嵌套函数在引用函数参数时也可能成为闭包.

(十三)闭包

闭包 是与 自由变量 集绑定的嵌套函数. 自由变量是 outer 函数的局部变量, 嵌套函数也使用这些局部变量. 闭包允许一个或多个嵌套函数与 outer 函数共享变量, 即使 outer 函数返回后也是如此.

要创建一个闭包, 只需定义一个引用外部函数变量的嵌套函数. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

闭包也可以与内置函数一起使用, 如 SetTimer 或 Hotkey. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

如果一个嵌套函数捕获了外部函数的任何非静态局部变量, 那么它就自动成为一个闭包. 对应于闭包本身的变量(如 activate) 也是一个非静态局部变量, 所以任何引用闭包的嵌套函数都是自动闭包.

对外部函数的每次调用都会创建新的闭包, 与之前的任何调用不同.

最好不要将对闭包的引用存储在闭包自己的任何一个自由变量中, 因为这将创建一个循环引用, 而这个循环引用必须在闭包被释放之前被打破(例如通过清除变量). 然而, 一个闭包可以安全地用它们的原始变量来引用自己和其他闭包, 而不会产生循环引用. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

(十四)闭包的意义

  • 变量的封闭性: 闭包使得函数能够捕获其定义时所在的作用域中的变量,即使在函数定义的范围之外被调用,仍然可以访问到这些变量。这样,闭包可以将变量封装在函数内部,避免了全局变量的污染和命名冲突。
  • 状态的保持: 闭包可以在函数调用之间保持状态。由于闭包可以访问外部作用域中的变量,因此它们可以在多次调用之间保持状态。这在某些场景下非常有用,例如在事件处理或迭代器中,可以使用闭包来保存上下文状态。
  • 模块化和组合: 闭包使得代码更加模块化和可组合。通过将函数和其相关的数据封装在闭包中,可以将代码分解成更小的可重用单元,从而提高了代码的可读性和可维护性。此外,闭包还使得可以将不同的功能组合起来,形成更复杂的功能模块。
  • 回调和事件处理: 闭包在回调和事件处理中有广泛的应用。由于闭包可以捕获其定义时所在的作用域中的变量,因此它们可以用来传递参数和状态给回调函数,实现更灵活和功能丰富的事件处理机制。

Return, Exit 及一般说明

如果函数内的执行流在遇到 Return 前到达了函数的闭括号, 那么函数结束并返回空值(空字符串) 给其调用者. 当函数显式省略 Return 的参数时, 也返回空值.

当函数使用 Exit 终止当前线程时, 其调用者不会接收到返回值. 例如, 这个语句 Var := Add(2, 3) 中, 如果 Add() 退出了那么 Var 会保持不变. 如果因为 Throw 或运行时错误(如 运行一个不存在的文件), 也会发生同样的事情.

要使用一个或多个空值(空字符串) 调用函数, 可以使用空的引号对, 例如: FindColor(ColorName, "").

因为调用函数不会开启新线程, 所以函数对设置(如 SendMode 和 SetTitleMatchMode) 做出的任何改变对其调用者同样有效.

在函数中使用 ListVars 时, 它会显示函数的局部变量及其内容. 这样可以帮助调试脚本.

(十五)样式和命名约定

如果给复杂函数中的特定变量加上独特的前缀, 您可能会发现它们更易于阅读和维护. 例如, 在函数的参数列表中以 “p” 或 “p_” 开头命名每个参数, 可以让它们的性质一目了然, 尤其是当函数中有大量的局部变量吸引您的注意力的时候. 类似地, 前缀 “r” 或 “r_” 可用于 ByRef 参数, 而 “s” 或 “s_” 可用于静态变量.

在定义函数时可以选择使用 One True Brace(OTB) 样式. 例如:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

(十六)使用 #Include 在多个脚本间共享函数

库文件夹提供了一些标准位置来保存其他脚本通过 #Include 方式利用的共享脚本. 一个库脚本通常包含一个函数或类, 它被设计成以这种方式使用和重用. 将库脚本放置在其中的一个位置, 可以更容易地编写脚本, 这些脚本可以与他人共享, 并在多个设置中工作. 库的位置是:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

库文件夹按照上面显示的顺序进行搜索.

例如, 如果一个脚本包含行 #Include <MyLib>, 程序就会在本地库中搜索一个名为 “MyLib.ahk” 的文件. 如果在那里没有找到, 它就会在用户库中搜索它, 直至在标准库中搜索. 如果仍然没有找到匹配, 并且库的名称包含下划线(例如 MyPrefix_MyFunc), 则程序只使用前缀(例如 MyPrefix.ahk) 再次搜索.

虽然按照惯例, 一个库文件通常只包含一个与其文件名同名的函数或类, 但它也可能包含只被它调用的私有函数. 然而, 这些函数应该有相当不同的名字, 因为它们仍然在全局命名空间中; 也就是说, 它们可以在脚本的任何地方被调用.

(十七)内置函数

如果脚本定义了与内置函数同名的函数, 那么内置函数会被覆盖. 例如, 脚本会调用它自己定义的 WinExist() 函数来代替标准的那个. 然而, 这样脚本将无法调用原来的函数.

在 DLL 文件中的外部函数可以使用 DllCall() 调用.

获取所有内置函数的列表, 请参阅函数列表.

名称 描述
{ … } (区块) 区块是用大括号括起来的一个或多个语句. 通常与函数定义和控制流语句一起使用.
{ … } / Object 根据属性名称和值对列表创建对象.
[ … ] / Array 根据一系列参数值创建数组.
Abs 返回指定数字的绝对值.
ASin 返回以弧度表示的反正弦值(其正弦值为指定数字).
ACos 返回以弧度表示的反余弦值(其余弦值为指定数字).
ATan 返回以弧度表示的反正切值(其正切值为指定数字).
BlockInput 禁用或启用用户通过键盘和鼠标与计算机交互的能力.
Break 退出(终止) 任意类型的 loop 语句.
Buffer 创建缓冲, 它封装了一个内存块, 以便与其他函数一起使用.
CallbackCreate 创建一个机器码地址, 当调用该地址时, 将重定向调用到脚本中的函数.
CallbackFree 删除回调函数并释放其对函数对象的引用.
CaretGetPos 检索插入符号的当前位置(文本插入点).
Catch 指定在执行 Try 语句抛出值或错误时执行的一或多条语句.
Ceil 返回指定数字向上取整后的整数(不含任何 .00 后缀).
Chr 返回与指定数字所表示的编码相对应的字符串(通常是单个字符).
Click 在指定坐标处点击鼠标按钮. 它还可以按下鼠标按钮, 转动鼠标滚轮或移动鼠标.
ClipboardAll 创建一个包含剪贴板上的所有内容的对象(如图片和格式).
ClipWait 等待, 一直到剪贴板包含数据.
ComCall 通过索引调用原生 COM 接口方法.
ComObjActive 检索已注册的 COM 对象.
ComObjArray 创建用于 COM 的 SafeArray.
ComObjConnect 将 COM 对象的事件源连接到脚本, 使事件能够被处理.
ComObject 创建 COM 对象.
ComObjFlags 检索或更改控制 COM 包装器对象行为的标志.
ComObjFromPtr 包装一个原始 IDispatch 指针(COM 对象), 以供脚本使用.
ComObjGet 返回由 COM 组件提供的对象引用.
ComObjQuery 查询 COM 对象的接口或服务.
ComObjType 从 COM 对象检索类型信息.
ComObjValue 检索存储在 COM 包装器对象中的值或指针.
ComValue 包装一个值, 安全数组或 COM 对象, 以供脚本使用或传递给 COM 方法.
Continue 跳过当前 loop 语句的剩余部分并继续下一次循环.
ControlAddItem 将指定的字符串作为新条目添加到列表框或组合框的底部.
ControlChooseIndex 将列表框, 组合框或标签页控件中的选择设置为指定的条目或选项卡编号.
ControlChooseString 将列表框或组合框中的选择设置为前导部分与指定字符串匹配的第一个条目.
ControlClick 向控件发送鼠标按钮或鼠标滚轮事件.
ControlDeleteItem 从列表框或组合框中删除指定的条目编号.
ControlFindItem 返回与指定字符串完全匹配的列表框或组合框的条目编号.
ControlFocus 设置窗口上给定控件的输入焦点.
ControlGetChecked 如果选中复选框或单选按钮, 返回非零值.
ControlGetChoice 返回列表框或组合框中当前选定项的名称.
ControlGetClassNN 返回指定控件的 ClassNN(类名和序号).
ControlGetEnabled 如果指定的控件是启用的, 返回非零值.
ControlGetFocus 检索目标窗口的哪个控件具有键盘焦点(如果有的话).
ControlGetHwnd 返回指定控件的唯一 ID 号.
ControlGetIndex 返回 ListBox, ComboBox 或 Tab 控件中当前选中的条目或标签的索引.
ControlGetItems 从列表视图, 列表框, 组合框或下拉列表中返回项目/行的数组.
ControlGetPos 获取控件的位置和大小.
ControlGetStyle
ControlGetExStyle
返回一个表示指定控件的样式或扩展样式的整数.
ControlGetText 从控件检索文本.
ControlGetVisible 如果指定的控件是可见的, 则返回非零值.
ControlHide 隐藏指定的控件.
ControlHideDropDown 隐藏组合框控件的下拉列表.
ControlMove 移动或调整控件的大小.
ControlSend
ControlSendText
向窗口或控件发送模拟的击键或文本.
ControlSetChecked 打开(选中) 或关闭(取消选中) 复选框或单选按钮.
ControlSetEnabled 启用或禁用指定的控件.
ControlSetStyle
ControlSetExStyle
分别更改指定控件的样式或扩展样式.
ControlSetText 更改控件的文本.
ControlShow 显示先前隐藏的指定控件.
ControlShowDropDown 显示组合框控件的下拉列表.
CoordMode 为多个内置函数设置坐标模式, 相对于活动窗口还是屏幕.
Cos 返回 Number 的余弦值.
Critical 防止当前线程被其他线程中断, 或开启允许被中断.
DateAdd 日期-时间值加上或减去时间.
DateDiff 比较两个日期-时间值并返回差值.
DetectHiddenText 设置在查找窗口时是否 “看见” 隐藏的文本. 这将影响 WinExist 和 WinActivate 等窗口命令.
DetectHiddenWindows 设置脚本是否可以 “看见” 隐藏的窗口.
DirCopy 复制文件夹及其所有子文件夹和文件(类似于 xcopy), 或者复制归档文件(如 ZIP) 的全部内容.
DirCreate 创建目录.
DirDelete 删除目录.
DirExist 检查文件夹是否存在并返回其属性.
DirMove 移动文件夹及其所有子文件夹和文件. 它也可以重命名一个文件夹.
DirSelect 显示可以让用户选择文件夹的标准对话框.
DllCall 调用 DLL 文件中的函数, 例如标准的 Windows API 函数.
Download 从互联网下载文件.
DriveEject 弹出或收回指定 CD/DVD 驱动器的托盘, 或弹出可移动驱动器.
DriveGetCapacity 返回包含指定路径的驱动器的总容量, 单位为 mb(兆字节).
DriveGetFileSystem 返回指定驱动器的文件系统的类型.
DriveGetLabel 返回指定驱动器的卷标.
DriveGetList 返回一串字母, 系统中的每个驱动器字母对应一个字符.
DriveGetSerial 返回指定驱动器的卷序列号.
DriveGetSpaceFree 包含指定路径的驱动器的空闲磁盘空间, 单位为 mb(兆字节).
DriveGetStatus 返回包含指定路径的驱动器的状态.
DriveGetStatusCD 返回指定 CD/DVD 驱动器的媒体状态.
DriveGetType 返回包含指定路径的驱动器类型.
DriveLock 阻止指定驱动器的弹出功能正常工作.
DriveRetract 收回指定 CD/DVD 驱动器的托盘.
DriveSetLabel 更改指定驱动器的卷标签.
DriveUnlock 恢复指定驱动器的弹出功能.
Edit 在默认编辑器中打开当前脚本进行编辑.
EditGetCurrentCol 返回编辑控件中插入符号(文本插入点) 所在的列号.
EditGetCurrentLine 返回编辑控件中插入符号(文本插入点) 所在的行号.
EditGetLine 返回编辑控件中指定行的文本.
EditGetLineCount 返回编辑控件中的行数.
EditGetSelectedText 返回编辑控件中选定的文本.
EditPaste 将指定的字符串粘贴到编辑控件中的插入符号(文本插入点) 处.
Else 如果关联语句的主体没有执行, 指定要执行的一个或多个语句.
EnvGet 检索环境变量的值.
EnvSet 将值写入指定的环境变量中.
Exit 退出当前线程.
ExitApp 终止脚本.
Exp 返回 e(近似值为 2.71828182845905) 的 N 次幂.
FileAppend 在文件末尾写入文本或二进制数据(如果需要, 首先创建文件).
FileCopy 复制一个或多个文件.
FileCreateShortcut 创建快捷方式(.lnk) 文件.
FileDelete 删除一个或多个文件.
FileEncoding 为 FileRead, Loop Read, FileAppend 和 FileOpen 设置默认编码.
FileExist 检查文件或目录是否存在并返回它的属性.
FileInstall 在已编译的脚本中包含指定的文件.
FileGetAttrib 报告文件或文件夹是否为只读, 隐藏等.
FileGetShortcut 获取快捷方式(.lnk) 文件的信息, 例如其目标文件.
FileGetSize 获取文件的大小.
FileGetTime 获取文件或文件夹的时间戳.
FileGetVersion 检索文件的版本.
FileMove 移动或重命名一个或多个文件.
FileOpen 打开文件, 从其中读取特定内容和/或将新内容写入其中.
FileRead 检索文件的内容.
FileRecycle 如果可能发送文件或目录到回收站, 或永久删除该文件.
FileRecycleEmpty 清空回收站.
FileSelect 显示可以让用户打开或保存文件的标准对话框.
FileSetAttrib 改变一个或多个文件或文件夹的属性. 支持通配符.
FileSetTime 改变一个或多个文件或文件夹的时间戳. 支持通配符.
Finally 确保在 Try 语句完成之后始终执行一条或多条语句.
Float 将数字字符串或整数值转换为浮点数.
Floor 返回指定数字向下取整后的整数(不含任何 .00 后缀).
For 对对象中的每对键值对重复执行一或多条语句.
Format 根据格式字符串格式化一个可变数量的输入值.
FormatTime 将 YYYYMMDDHH24MISS 时间戳转换为指定的日期/时间格式.
GetKeyName 检索按键的名称/文本.
GetKeyVK 检索按键的虚拟键码.
GetKeySC 检索按键的扫描码.
GetKeyState 根据指定的键盘按键或鼠标/控制器按钮是上还是下, 返回 1 (true) 或 0(false). 也检索控制器状态.
GetMethod 检索方法的实现函数.
Goto 跳转到指定的标签并继续执行.
GroupActivate 激活由 GroupAdd 定义的窗口组中的下一个窗口.
GroupAdd 增加窗口规格到窗口组, 必要时创建组.
GroupClose 关闭刚刚被 GroupActivate 或 GroupDeactivate 激活的活动窗口. 接着激活系列中的下一个窗口. 它还可以关闭组中所有窗口.
GroupDeactivate 类似于 GroupActivate, 不同的是它激活 不 在组中的下一个窗口.
Gui() 创建并返回一个新的 Gui 对象. 这可以用来定义一个自定义窗口或图形用户界面(GUI), 以显示信息或接受用户输入.
GuiCtrlFromHwnd 检索与指定的窗口句柄关联的 GUI 控件的 GuiControl 对象.
GuiFromHwnd 检索与指定的窗口句柄关联的 Gui 窗口的 Gui 对象.
HasBase 如果指定的值派生自指定的基对象, 则返回非零数字.
HasMethod 如果指定的值具有指定名称的方法, 则返回非零数字.
HasProp 如果指定值具有指定名称的属性, 则返回非零数字.
HotIf / HotIfWin… 指定后续创建或修改热键变体和热字串变体的条件.
Hotkey 在脚本运行时创建, 修改, 启用或禁用热键.
Hotstring 在脚本运行时创建, 修改, 启用或禁用热字串.
If (expression) 指定在表达式计算结果为 True(真) 时要执行的语句.
IL_Create
IL_Add
IL_Destroy
将图标添加到 ListView 或 TreeView 控件的方法.
ImageSearch 在屏幕的某个区域中搜索图像.
IniDelete 删除标准格式的 .ini 文件中的值.
IniRead 从标准 ini 格式文件中读取一个值, 一个段或段名列表.
IniWrite 写入值或段到标准格式的 .ini 文件.
InputBox 显示输入框让用户输入字符串.
InputHook 创建一个可用于收集或拦截键盘输入的对象.
InstallKeybdHook 安装或卸载键盘钩子.
InstallMouseHook 安装或卸载鼠标钩子.
InStr 从左边或右边搜索一个字符串的给定 occurrence(出现).
Integer 将数字字符串或浮点值转换为整数.
IsLabel 如果当前作用域中存在指定的标签, 则返回非零数字.
IsObject 如果指定的值是对象, 则返回非零数字.
IsSet / IsSetRef 如果指定变量已经被赋值, 则返回一个非零数字.
KeyHistory 显示脚本信息和最近键击和鼠标点击的历史.
KeyWait 等待按键或鼠标/控制器按钮被松开或按下.
ListHotkeys 显示当前脚本使用的热键, 不论它们的子程序当前是否运行, 也不论它们是否使用键盘或鼠标钩子.
ListLines 启用或禁用行日志记录或显示最近执行的脚本行.
ListVars 显示脚本的变量: 它们的名称和当前的内容.
ListViewGetContent 返回 ListView 中的一个项目/行的列表.
LoadPicture 载入图像文件并返回位图或图标句柄.
Log 返回指定数字的对数(10 为底).
Ln 返回指定数字的自然对数(e 为底).
Loop (normal) 重复执行一或多条语句: 可以指定重复次数或直到遇到 Break.
Loop Files 检索指定的文件或文件夹, 每次一个.
Loop Parse 每次从字符串中检索字符串(片段).
Loop Read 检索文本文件中的行, 每次一行.
Loop Reg 检索指定的注册表子键的内容, 每次一个项目.
Map 根据键值对列表创建 Map(映射).
Max 返回一组数字中的最大值.
MenuBar() 创建一个 MenuBar 对象, 该对象可用于定义 GUI 菜单栏.
Menu() 创建一个 Menu 对象, 可用于创建和显示菜单.
MenuFromHandle 检索对应于 Win32 菜单句柄的 Menu 或 MenuBar 对象.
MenuSelect 从指定窗口菜单栏中调用菜单项.
Min 返回一组数字中的最小值.
Mod 取模. 返回一个数字(被除数) 除以另一个数字(除数) 的余数.
MonitorGet 检查指定的监视器是否存在, 并可选地检索其边界坐标.
MonitorGetCount 返回监视器的数量.
MonitorGetName 返回指定监视器的操作系统名称.
MonitorGetPrimary 返回主监视器的编号.
MonitorGetWorkArea 检查指定的监视器是否存在, 并可选地检索其工作区域的边界坐标.
MouseClick 点击或按住鼠标按钮, 或滚动鼠标滚轮. 注意: Click 函数通常更灵活和易于使用.
MouseClickDrag 点击并按住指定的鼠标按钮, 接着移动鼠标到目标坐标, 然后松开该按钮.
MouseGetPos 获取鼠标光标的当前位置, 和可选的它悬停在哪个窗口和控件上.
MouseMove 移动鼠标光标.
MsgBox 在含有一个或多个按钮(例如 “是” 和 “否”) 的小窗口中显示指定的文本.
Number 将一个数字字符串转换为一个纯整数或浮点数.
NumGet 返回存储在指定地址+偏移量处的二进制数.
NumPut 将一个或多个数字以二进制格式存储在指定的地址+偏移量.
ObjAddRef / ObjRelease 增加或减少对象的引用计数.
ObjBindMethod 创建一个绑定函数对象, 它能调用指定对象的方法.
ObjHasOwnProp
ObjOwnProps
这些函数等同于 Object 类型的内置方法. 通常推荐使用相应的方法来代替.
ObjGetBase 检索对象的基对象.
ObjGetCapacity 返回对象内部属性数组的当前容量.
ObjOwnPropCount 返回对象拥有的属性的数量.
ObjSetBase 设置对象的基对象.
ObjSetCapacity 设置对象内部自有属性数组的当前容量.
OnClipboardChange 注册一个每当剪贴板内容发生改变时, 自动调用的函数.
OnError 注册一个当未处理错误发生时, 自动调用的函数.
OnExit 注册一个当脚本退出时, 自动调用的函数.
OnMessage 注册一个当脚本接收到指定消息时, 自动调用的函数.
Ord 返回指定字符串中首个字符的序号值(数字字符编码).
OutputDebug 发送字符串到调试器(如果有) 显示出来.
Pause 暂停脚本的当前线程.
Persistent 防止脚本在最后一个线程完成后自动退出, 允许它在空闲状态下运行.
PixelGetColor 获取指定的 X 和 Y 坐标处像素的颜色.
PixelSearch 在屏幕某个区域中搜索指定颜色所在的像素.
PostMessage 将消息放入窗口或控件的消息队列中.
ProcessClose 强制关闭第一个匹配的进程.
ProcessExist 检查指定的进程是否存在.
ProcessGetName 返回指定进程的名称.
ProcessGetParent 返回创建指定进程的进程 ID(PID).
ProcessGetPath 返回指定进程的路径.
ProcessSetPriority 更改第一个匹配进程的优先级.
ProcessWait 等待指定的进程存在.
ProcessWaitClose 等待匹配进程关闭.
Random 生成一个伪随机数字.
RegExMatch 判断字符串是否包含某个匹配模式(正则表达式).
RegExReplace 替换字符串中匹配模式(正则表达式) 出现的地方.
RegCreateKey 创建注册表键而不写入值.
RegDelete 从注册表中删除值.
RegDeleteKey 从注册表中删除子键.
RegRead 从注册表读取值.
RegWrite 写入值到注册表.
Reload 使用新的脚本实例替换当前正在运行的.
Return 从函数返回到之前通过函数调用, Hotkey 激活, 或其他方式执行跳转的地方.
Round 返回指定数字四舍五入到 N 位小数的数字.
Run 运行外部程序.
RunAs 指定一组用户凭据, 应用于后续所有的 Run 和 RunWait 函数.
RunWait 运行一个外部程序并且等待它运行完毕.
Send / SendText / SendInput / SendPlay / SendEvent 发送模拟键击和鼠标点击到活动窗口.
SendLevel 控制热键和热字串是否忽略模拟的键盘和鼠标事件.
SendMessage 发送消息到窗口或控件并等待回复.
SendMode 使 Send 等同于 SendEvent 或 SendPlay, 而不是默认的(SendInput). 也使 Click 和 MouseMove/Click/Drag 使用指定的方法.
SetCapsLockState 设置 CapsLock 的状态. 还可以强制此按键保持打开或关闭状态.
SetControlDelay 设置每个控件改动函数后将发生的延迟.
SetDefaultMouseSpeed 设置在 Click, MouseMove, MouseClick 和 MouseClickDrag 中没有指定鼠标速度时使用的速度.
SetKeyDelay 设置每次 Send 或 ControlSend 发送键击后自动的延时.
SetMouseDelay 设置每次鼠标移动或单击后发生的延迟.
SetNumLockState 设置 NumLock 的状态. 还可以强制此按键保持打开或关闭状态.
SetScrollLockState 设置 ScrollLock 键的状态. 还可以强制此按键保持打开或关闭状态.
SetRegView 设置 RegRead, RegWrite, RegDelete, RegDeleteKey 和 Loop Reg 使用的注册表视图, 允许它们在 32 位脚本中访问 64 位注册表视图, 反之亦然.
SetStoreCapsLockMode 在 Send 之后是否恢复 CapsLock 的状态.
SetTimer 在指定的时间间隔自动重复的调用函数.
SetTitleMatchMode 设置 WinTitle 参数在内置函数中的匹配行为, 如 WinWait.
SetWinDelay 设置在每次执行窗口函数(例如 WinActivate) 后的延时.
SetWorkingDir 更改脚本当前的工作目录.
Shutdown 关机, 重启或注销系统.
Sin 返回指定数字的三角正弦值.
Sleep 在继续前等待指定的时间量.
Sort 以字母, 数字或随机顺序排列变量的内容(可以选择是否移除重复项).
SoundBeep 从 PC 扬声器发出声音.
SoundGetInterface 检索声音设备或组件的原生 COM 接口.
SoundGetMute 检索声音设备的静音设置.
SoundGetName 检索声音设备或组件的名称.
SoundGetVolume 检索声音设备的音量设置.
SoundPlay 播放音频, 视频或其他支持的文件类型.
SoundSetMute 更改声音设备的静音设置.
SoundSetVolume 更改声音设备的音量设置.
SplitPath 将文件名(路径) 或 URL 分解成它的名称, 目录, 扩展名和驱动器.
Sqrt 返回指定数字的平方根.
StatusBarGetText 获取标准状态栏控件的文本.
StatusBarWait 等待直到窗口的状态栏包含指定的字符串.
StrCompare 按字母顺序比较两个字符串.
StrGet 从内存地址或缓冲中复制字符串, 可选地从给定的代码页进行转换.
String 将值转换为字符串.
StrLen 检索字符串中的字符数.
StrLower 将字符串转换为小写.
StrPtr 返回字符串的当前内存地址.
StrPut 复制字符串到内存地址或缓冲, 可选地将字符串转换到给定的代码页.
StrReplace 用新字符串替换指定的子字符串.
StrSplit 使用指定的分隔符将字符串分成子字符串数组.
StrTitle 将字符串转换为标题大写.
StrUpper 将字符串转换为大写.
SubStr 从字符串中的指定位置检索一个或多个字符.
Suspend 禁用或启用所有的或选择的热键和热字串.
Switch 将一个值与多个实例进行比较, 并执行第一个匹配的语句.
SysGet 获取系统对象的尺寸和其他系统属性.
SysGetIPAddresses 返回系统的 IPv4 地址数组.
Tan 返回指定数字的三角正切值.
Thread 设置线程的优先级或是否可以被中断. 它也可以临时禁用所有的计时器.
Throw 发生错误时发出信号. 此信号可以被 Try-Catch 语句捕获.
ToolTip 在屏幕的任意位置显示一个置顶的窗口.
TraySetIcon 更改脚本的托盘图标(该图标也使用于 GUI 和对话框窗口).
TrayTip 在托盘图标附近显示一个气球提示窗口. 在 Windows 10 及后续版本中, 会显示一个 toast 通知
Trim / LTrim / RTrim 移除字符串开头和/或末尾的字符.
Try 守护一个或多个语句以防备由 Throw 语句抛出的运行时错误和值.
Type 返回值的类名.
Until 根据条件判断是否继续执行 Loop 或 For 循环.
VarSetStrCapacity 增加变量的容量或释放其内存. 一般情况下不需要, 但可以与 DllCall 或 SendMessage 一起使用, 或者优化重复连接.
VerCompare 对比两个版本字符串.
While-loop 重复执行一或多条语句, 直到指定的表达式计算结果为假时终止.
WinActivate 激活指定的窗口.
WinActivateBottom 与 WinActivate 相同, 只是此函数激活最下面的匹配窗口而不是最上面的.
WinActive 检查指定的窗口是否被激活并返回其唯一 ID(HWND).
WinClose 关闭指定的窗口.
WinExist 检查指定的窗口是否存在并返回其唯一 ID(HWND).
WinGetClass 获取指定窗口的类名.
WinGetClientPos 检索指定窗口的工作区的位置和大小.
WinGetControls 返回指定窗口中所有控件名称(ClassNN) 的数组.
WinGetControlsHwnd 返回指定窗口中所有控件的唯一 ID 号(HWND) 的数组.
WinGetCount 返回符合指定条件的现有窗口的数目.
WinGetID 返回指定窗口的唯一 ID 号(HWND).
WinGetIDLast 如果找到多个匹配窗口, 则返回最后的/最底部的窗口的唯一 ID 号(HWND).
WinGetList 返回与指定条件匹配的所有现有窗口的唯一 ID 号(HWND) 的数组.
WinGetMinMax 如果指定的窗口被最大化或最小化, 则返回一个非零数字.
WinGetPID 返回指定窗口的进程 ID(PID).
WinGetPos 获取指定窗口的位置和大小.
WinGetProcessName 返回指定窗口的进程的名称.
WinGetProcessPath 返回拥有指定窗口的进程的完整路径和名称.
WinGetStyle
WinGetExStyle
分别返回指定窗口的样式和扩展样式.
WinGetText 从指定窗口检索文本.
WinGetTitle 检索指定窗口的标题.
WinGetTransColor 返回指定窗口中标记为透明的颜色.
WinGetTransparent 返回指定窗口的透明度的等级.
WinHide 隐藏指定的窗口.
WinKill 强制关闭指定的窗口.
WinMaximize 将指定的窗口放大到最大尺寸.
WinMinimize 将指定的窗口最小化为任务栏上的按钮.
WinMinimizeAll / WinMinimizeAllUndo 最小化或还原所有窗口.
WinMove 改变指定窗口的位置和/或大小.
WinMoveBottom 发送指定的窗口到堆栈的底部; 也就是说, 在所有其他窗口下方.
WinMoveTop 将指定的窗口移到堆栈顶部, 而无需显式激活它.
WinRedraw 重绘指定窗口.
WinRestore 如果指定的窗口处于最小化或最大化状态, 则还原它.
WinSetAlwaysOnTop 使指定的窗口停留在所有其他窗口的顶部(除了其他置顶窗口).
WinSetEnabled 启用或禁用指定的窗口.
WinSetRegion 将指定窗口的形状改为指定的矩形, 椭圆或多边形.
WinSetStyle
WinSetExStyle
分别改变指定窗口的样式和扩展样式.
WinSetTitle 更改指定窗口的标题.
WinSetTransColor 使所选颜色的所有像素在指定的窗口内不可见(透明).
WinSetTransparent 使指定的窗口半透明.
WinShow 显示指定的窗口.
WinWait 等待直到指定的窗口存在.
WinWaitActive / WinWaitNotActive 等待直到指定的窗口处于活动或不活动状态.
WinWaitClose 等待直到找不到匹配的窗口.
#ClipboardTimeout 更改首次尝试访问剪贴板失败时脚本继续尝试访问剪贴板的时间.
#DllLoad 在脚本开始执行之前加载 DLL 或 EXE 文件.
#ErrorStdOut 把任何阻止脚本运行的语法错误发送到标准错误(stderr), 而不是显示一个对话框.
#Hotstring 改变热字串的选项或终止符.
#HotIf 创建上下文相关的热键和热字串. 这些热键根据任何条件(表达式) 执行不同的操作(或什么都不做).
#HotIfTimeout 设置计算单个 #HotIf 表达式可以使用的最大时间.
#Include / #IncludeAgain 使脚本的行为与指定文件的内容位于此确切位置一样.
#InputLevel 控制热键和热字串是否忽略模拟的键盘和鼠标事件.
#MaxThreads 设置可同时存在的线程的最大数目.
#MaxThreadsBuffer 当某些或所有的热键达到 #MaxThreadsPerHotkey 限制时, 这个指令让它们缓冲而不是忽略键击.
#MaxThreadsPerHotkey 设置每个热键或热字串可同时存在的最大线程数.
#NoTrayIcon 禁止托盘图标的显示.
#Requires 如果不符合版本要求, 则显示错误并退出.
#SingleInstance 决定当脚本已经运行时是否允许它再次运行.
#SuspendExempt 从暂停状态中, 豁免后续的热键和热字串.
#UseHook 强制使用钩子实现全部或部分键盘热键.
#Warn 启用或禁用特定条件下的警告, 这些条件可能会产生错误, 例如书写错误或缺少 “global(全局)” 声明.
#WinActivateForce 跳过温和的方法而直接使用强制的方法激活窗口.

三、例子

自动整理 v1.1

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
20
20积分

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

给TA捐赠
共{{data.count}}人
人已捐赠
AI 自动化教程

web自动化编程工具(持续更新)

2018-11-10 23:23:29

教程

2.9循环结构(loop、while、for)

2018-11-12 21:41:42

5 条回复 A文章作者 M管理员
  1. maxs

    热字符串的方式,怎么样可以运行一个函数?

    • hexuren

      直接调用函数就可以了

  2. Pentakill

    分析很详细,懂了

  3. 格物致知

    这个没看懂,小白看不懂

    • hexuren

      哪里没看懂?

❯
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索