代码片段
代码片段 是一段不绑定任何触发器的命名步骤或脚本。操作、前置和后置脚本、全局事件以及其他代码片段都可以按名称运行它。将某些内容写成代码片段一次,每个调用它的操作都会使用同一份内容:更改代码片段,它们都会随之改变。
自动化
操作
文本扩展
代码片段
录制器
沙盒
应用程序组
忽略组
手势
引擎
全局事件
排除区域
脚本
插件
设置
常规
外观
配置方案
控制台
安全
帮助
关于
您的代码片段
Center window
使用者:2
粘贴纯文本
代码片段
Center window
1Center window
2窗口
仅用于显示,不会改变代码片段的运行方式。
脚本
3SnippetExecuteScript("Center window");
步骤脚本
1窗口居中目标窗口
4
调用方
向左滑动
浏览器:前置脚本
代码片段列表
列表在每个类别的标题下显示库中的所有代码片段:类别按名称排序,然后是 未分类,每个类别内按名称排序。被调用的代码片段会显示 使用者 和调用方的数量。
- + 新建 会在所选代码片段的类别中添加一个名为 新建代码片段、以步骤方式编写的代码片段。
- + 新建 旁边的复制按钮会以一个新的唯一名称复制所选代码片段。
- 某一行上的删除按钮会删除代码片段(删除代码片段)。
名称和类别
- 名称 ① 是调用方查找代码片段的依据。无论类别如何,它在整个库中都必须唯一,只有大小写不同的两个名称会被视为相同。它不能包含双引号、反斜杠或控制字符。违反规则的名称会以红色显示并附上原因,离开该框时会恢复为原来的名称。
- 重命名 代码片段会改写配置中所有用引号写出该名称的调用(谁调用了代码片段)。
- 类别 ② 只用于对列表分组。它不会改变代码片段的运行方式。
代码片段执行的内容
编写方式 用于选择 步骤 或 脚本,与操作相同(步骤、脚本和 AutoHotkey)。从步骤切换到脚本时,会像在“操作”页面上一样提议转换步骤。
- 在步骤方式下,编辑器与操作的编辑器相同(步骤编辑器)。
- 在脚本方式下,检查语法 会用引擎自己的编译器检查脚本。它会报告 解析成功 及行数,或者报告第一个错误,并在编辑器中为问题加下划线。
- 只有已经以 AutoHotkey 方式运行的代码片段才会提供 AutoHotkey。
- 这里没有运行代码片段的按钮。要安全地试用步骤,请使用沙盒。
备注
高级模式。 在编辑器上方,会以脚本形式显示运行此代码片段的调用 ③,并附有一个复制它的按钮。
调用代码片段
当某个步骤或脚本使用代码片段的名称调用内置函数 SnippetExecuteScript 时,该代码片段就会运行:
- 在步骤中,从所有内置函数的列表中添加一个 运行代码片段 步骤(
SnippetExecuteScript)(添加步骤),并在其 名称 中键入代码片段的名称。 - 在脚本中,编写调用:
SnippetExecuteScript("Center window");
它的运行方式:
- 调用方会等待代码片段完成,然后继续。
- 代码片段能看到启动调用方的内容(其目标窗口、手势等),因此代码片段中的 目标窗口 就是调用方的目标窗口。
- 代码片段有自己的变量。它无法读取调用方的变量,调用方也无法读取它的变量。
- 名称必须完全匹配,包括大小写。如果没有代码片段使用该名称,则不运行任何内容,调用返回
false。 - 只有当代码片段运行到末尾时,调用才返回
true。当代码片段为空、有错误或被停止时,也会返回false。 - 代码片段可以调用其他代码片段。没有任何机制阻止代码片段调用自身,因此请确保这样的调用链会结束。
谁调用了代码片段
调用方 卡片 ④ 列出调用此代码片段的每个操作、前置或后置脚本、全局事件(即使已关闭)和代码片段。全局事件会标记为 全局事件,代码片段会标记为 代码片段。
只能找到用引号写出代码片段名称的调用。在运行时构造名称的调用不会列出,而注释中的调用会列出。不会搜索 AutoHotkey 正文。
删除代码片段
只要 调用方 下列出的任何内容仍在调用某个代码片段,您就无法删除它。这时删除按钮会显示 无法删除 以及调用方列表;请先更改或删除这些调用。没有任何内容调用的代码片段会在确认后被删除。
列表看不到的调用(在脚本运行时构造的名称)不受保护:如果您删除了那个代码片段,该调用将找不到任何内容并返回 false。
来自其他地方的代码片段
两者都会在此页面上打开新的代码片段,并将光标置于其 名称 中,以便重命名。已被占用的名称会添加 -1、-2 等后缀。