跳到主要内容

代码片段

代码片段 是一段不绑定任何触发器的命名步骤或脚本。操作、前置和后置脚本、全局事件以及其他代码片段都可以按名称运行它。将某些内容写成代码片段一次,每个调用它的操作都会使用同一份内容:更改代码片段,它们都会随之改变。

Input.Observer简单高级
自动化
操作
文本扩展
代码片段
录制器
沙盒
应用程序组
忽略组
手势
引擎
全局事件
排除区域
脚本
插件
设置
常规
外观
配置方案
控制台
安全
帮助
关于
您的代码片段
Center window
使用者:2
粘贴纯文本
+ 新建
代码片段
Center window
Center window
窗口
仅用于显示,不会改变代码片段的运行方式。
脚本
SnippetExecuteScript("Center window");
步骤脚本
1窗口居中目标窗口
调用方
向左滑动
浏览器:前置脚本

代码片段列表​

列表在每个类别的标题下显示库中的所有代码片段:类别按名称排序,然后是 未分类,每个类别内按名称排序。被调用的代码片段会显示 使用者 和调用方的数量。

  • + 新建 会在所选代码片段的类别中添加一个名为 新建代码片段、以步骤方式编写的代码片段。
  • + 新建 旁边的复制按钮会以一个新的唯一名称复制所选代码片段。
  • 某一行上的删除按钮会删除代码片段(删除代码片段)。

名称和类别​

  • 名称 ① 是调用方查找代码片段的依据。无论类别如何,它在整个库中都必须唯一,只有大小写不同的两个名称会被视为相同。它不能包含双引号、反斜杠或控制字符。违反规则的名称会以红色显示并附上原因,离开该框时会恢复为原来的名称。
  • 重命名 代码片段会改写配置中所有用引号写出该名称的调用(谁调用了代码片段)。
  • 类别 ② 只用于对列表分组。它不会改变代码片段的运行方式。

代码片段执行的内容​

编写方式 用于选择 步骤 或 脚本,与操作相同(步骤、脚本和 AutoHotkey)。从步骤切换到脚本时,会像在“操作”页面上一样提议转换步骤。

  • 在步骤方式下,编辑器与操作的编辑器相同(步骤编辑器)。
  • 在脚本方式下,检查语法 会用引擎自己的编译器检查脚本。它会报告 解析成功 及行数,或者报告第一个错误,并在编辑器中为问题加下划线。
  • 只有已经以 AutoHotkey 方式运行的代码片段才会提供 AutoHotkey。
  • 这里没有运行代码片段的按钮。要安全地试用步骤,请使用沙盒。
备注

高级模式。 在编辑器上方,会以脚本形式显示运行此代码片段的调用 ③,并附有一个复制它的按钮。

调用代码片段​

当某个步骤或脚本使用代码片段的名称调用内置函数 SnippetExecuteScript 时,该代码片段就会运行:

  • 在步骤中,从所有内置函数的列表中添加一个 运行代码片段 步骤(SnippetExecuteScript)(添加步骤),并在其 名称 中键入代码片段的名称。
  • 在脚本中,编写调用:
SnippetExecuteScript("Center window");

它的运行方式:

  • 调用方会等待代码片段完成,然后继续。
  • 代码片段能看到启动调用方的内容(其目标窗口、手势等),因此代码片段中的 目标窗口 就是调用方的目标窗口。
  • 代码片段有自己的变量。它无法读取调用方的变量,调用方也无法读取它的变量。
  • 名称必须完全匹配,包括大小写。如果没有代码片段使用该名称,则不运行任何内容,调用返回 false。
  • 只有当代码片段运行到末尾时,调用才返回 true。当代码片段为空、有错误或被停止时,也会返回 false。
  • 代码片段可以调用其他代码片段。没有任何机制阻止代码片段调用自身,因此请确保这样的调用链会结束。

谁调用了代码片段​

调用方 卡片 ④ 列出调用此代码片段的每个操作、前置或后置脚本、全局事件(即使已关闭)和代码片段。全局事件会标记为 全局事件,代码片段会标记为 代码片段。

只能找到用引号写出代码片段名称的调用。在运行时构造名称的调用不会列出,而注释中的调用会列出。不会搜索 AutoHotkey 正文。

删除代码片段​

只要 调用方 下列出的任何内容仍在调用某个代码片段,您就无法删除它。这时删除按钮会显示 无法删除 以及调用方列表;请先更改或删除这些调用。没有任何内容调用的代码片段会在确认后被删除。

列表看不到的调用(在脚本运行时构造的名称)不受保护:如果您删除了那个代码片段,该调用将找不到任何内容并返回 false。

来自其他地方的代码片段​

  • 录制器页面上的 创建代码片段 会将录制内容转换为代码片段。
  • 沙盒页面上的 另存为代码片段 会保存您在那里试用的步骤或脚本。

两者都会在此页面上打开新的代码片段,并将光标置于其 名称 中,以便重命名。已被占用的名称会添加 -1、-2 等后缀。