步骤参数
选择一个步骤后,其字段会在下方展开,步骤所需的每项细节各对应一个字段。每个字段都以通俗的文字作为标签。指向某个字段即可看到说明其用途的工具提示。
字段类型
| 字段 | 外观 | 接受的内容 |
|---|---|---|
| 文本 | 文本框 | 任意文本 |
| 整数 | 文本框 | 整数(例如 250 或 -3)、以 0x 开头的十六进制数(例如 0xB3),或命名常量(例如 VirtualKey.MediaPlayPause) |
| 数字 | 文本框 | 以句点作为小数点的数字,例如 0.5,与您的区域格式无关 |
| 真或假 | 开关 | 打开(true)或关闭(false) |
| 命名值的选项 | 下拉列表 ② | 所列名称之一,例如 MouseButton.Primary;您也可以在其中键入 |
| 窗口 | 文本框 | 来自值菜单或变量的窗口,通常为 目标窗口 |
| 按键(发送按键) | 按键捕获框 | 您按下的组合键 |
在每种字段中,您也可以键入 $ 加变量名称,以使用前面某个步骤保存的值(变量)。
无论您的区域格式如何,步骤字段中的数字始终使用句点作为小数点,并且不使用千位分隔符。
命名常量
整数或数字字段也接受命名常量:命名空间、一个点和一个名称,例如 VirtualKey.MediaPlayPause 或 AudioEndpoint.Playback,与脚本使用的名称相同(命名常量)。请准确键入,大小写相同,不含空格。步骤会保存该名称,操作在运行时使用其对应的数字。文本字段会将这样的名称保留为您键入的文本。
按键字段
发送按键 使用捕获框而不是文本框。单击它(单击以设置快捷键),然后按下组合键。只会记录组合键;设置期间不会发送任何内容。组合键无法表示的按键(例如媒体键)会被拒绝并显示一条消息。要按这些键,请使用 按下并释放键 步骤(KeyboardPressKey)并指定键名,例如 VirtualKey.MediaPlayPause(实用示例)。
新步骤会预先填好
新步骤的 窗口 字段一开始为 目标窗口:即绘制手势时所在的窗口,或者对于热键或键入文本则为拥有焦点的窗口。其开关一开始为关闭。其他所有字段一开始为空,由您填写。
从菜单中选择值
除 按键 和开关以外的每个字段末尾都有一个小箭头(选择一个值)。它会打开一个适合该字段的值菜单 ①。除了步骤自己的字段外,条件的 值 和 比较对象 字段及其单独的 值(条件)、重复的 次数(重复步骤)以及 设置变量 步骤的 值(变量)上也有该菜单。
| 分区 | 值 |
|---|---|
| 来自触发此操作的事件 | 目标窗口、目标控件、手势名称、操作名称、应用程序组名称、手势按钮,以及手势的 手势左边缘、手势上边缘、手势宽度 和 手势高度 |
| 在步骤运行时读取 | 活动窗口、鼠标 X 位置、鼠标 Y 位置、剪贴板文本、当前日期和时间 |
| 由前面的步骤保存 | 此步骤上方的步骤所保存的变量 |
菜单只列出与字段类型相符的值:数字字段也接受整数,接受任何内容的字段则接受全部值。次数 只提供整数;条件的字段和 设置变量 的值提供所有读取值。没有任何合适的值时,菜单会显示 此字段没有可选的值。
所选的值会以带有其名称的标签形式显示在文本框的位置。指向标签可查看它是什么以及脚本如何书写它。其 清除 按钮会清空该字段,以便您重新键入。
来自触发此操作的事件 下的值读取的是触发器:对于由热键或键入文本启动的操作,手势值为空或 0。由于代码片段可以从任何地方调用,所以在任何运行步骤的地方都会提供所有值。
在开关上,您之前键入的变量会显示为标签;清除该标签会将开关关闭。
键入时的检查
每个字段都会在您键入时进行检查。问题会以红色显示在字段下方,字段边框也会变成红色:
| 消息 | 含义 |
|---|---|
| 此值为必填项。 | 设置变量 步骤的变量名称为空。 |
| 请输入整数(十进制或 0x 十六进制)、命名常量,或一个 $变量。 | 整数字段中包含其他内容。 |
| 不存在此名称的命名常量。请检查拼写和大小写,例如 VirtualKey.MediaPlayPause。 | 整数或数字字段中包含命名空间、点和名称,但它不是命名常量。 |
| 请输入数字,或一个 $变量。 | 数字字段中包含其他内容。 |
| 请输入 true 或 false,或一个 $变量。 | 以文本形式键入的真或假字段中包含其他内容。 |
| 步骤不能在参数内运行内置函数。请先将其移入变量。 | 字段中包含一个括号内有内容的内置函数调用(见下文)。 |
当字段中包含未通过检查的键入文本时(例如整数或数字字段中的字母、不是命名常量的名称,或真或假字段中除 true 或 false 之外的任何内容),步骤不会被保存:操作会保留其上次保存的步骤,并且在您修复该字段之前,列表下方会显示 步骤未保存:步骤 N 有一个无效的字段(问题)。
空字段不会显示任何消息,也永远不会阻止保存;步骤会以空字段保存。操作运行时,数字、真或假或窗口字段为空的步骤会使操作在此处停止,控制台的 系统 输出会说明该参数的类型错误。空的文本字段会作为空文本运行,对于某些内置函数(文件名、要查找的窗口标题)而言,这意味着该步骤什么也不做。
移入变量
字段中只能放一个值、一个变量或值菜单中的某个读取值,而不能放带参数的内置函数调用。如果您键入了这样的调用,例如 WindowGetTitle($w),该字段会提供 移入变量。它会在此步骤正上方添加一个步骤,运行该调用并以取自该字段的名称(例如 window,然后是 window2)保存结果,并将该变量放入字段中。
括号内没有内容的调用(例如 ClipboardGetText())是可以的:它与从值菜单中选择该读取值相同。这适用于每个带有值菜单的字段,包括条件的字段、次数 和 设置变量 的值。
保存步骤的结果
大多数内置函数都会给出结果:读取的文本、找到的窗口,或者是否成功。将结果另存为 ③ 会以一个名称保存结果,以便后面的步骤可以用 $name 使用它。留空则忽略结果。
保存结果的步骤会在其摘要末尾显示“→ $name”。名称遵循变量中的规则。
运行时的类型错误
编辑器检查的是您键入内容的形式,而不是内置函数的每条规则。操作运行时,类型错误的值(例如在内置函数需要整数的地方,变量中保存的是文本)或内置函数拒绝的值会使操作停止,并在诊断控制台中显示错误。请参阅错误。