跳到主要内容

步骤参数

选择一个步骤后,其字段会在下方展开,步骤所需的每项细节各对应一个字段。每个字段都以通俗的文字作为标签。指向某个字段即可看到说明其用途的工具提示。

单击
X
鼠标 X 位置
Y
640
鼠标按钮
MouseButton.Primary
将结果另存为
可选。之后的步骤可以通过 $名称 使用该结果。
clicked

字段类型​

字段外观接受的内容
文本文本框任意文本
整数文本框整数(例如 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”。名称遵循变量中的规则。

运行时的类型错误​

编辑器检查的是您键入内容的形式,而不是内置函数的每条规则。操作运行时,类型错误的值(例如在内置函数需要整数的地方,变量中保存的是文本)或内置函数拒绝的值会使操作停止,并在诊断控制台中显示错误。请参阅错误。