跳到主要内容

变量

变量在步骤之间传递数据。前面步骤的输出放进变量,后面步骤再当输入用。

2.2.17 起,从步骤窗口的“变量”按钮打开时,左侧变量列表默认展开,便于集中管理;在右侧变量列表双击某个变量时,默认收起列表,集中编辑该变量。可用窗口中的列表开关切换视图。

可以把变量看成盒子:名字是标签,类型限制能放什么,默认值是一开始就在盒子里的东西。

下面这条链:获取选中文本 → 文本处理 → 把结果发回窗口。

stringProcess 的「待处理内容」应绑 selectedText。参数窗里是这样:

类型​

基础类型:文本、图片、布尔、日期时间、数字、数字(整数)。

高级类型:列表、词典、动态对象、表格。

输入和输出​

输入参数通常可以选变量,或改成固定值 / 插值 / 表达式,见 选择或输入步骤参数。

变量列表​

编辑器右侧是变量列表:添加、删除、清理未使用、排序、筛选。超过约 10 个变量时会出现筛选框。

行前可能还有用途图标:子程序输入 / 输出、作为状态使用。鼠标停上去能看到说明。

把变量拖到步骤列表,会自动加一条赋值。按住 Ctrl 拖列表类型变量,会自动加「每个」循环。

指定 C# 类型​

2.2.11 起,可选“指定类型”,填写必需的 C# 类型,例如 int、System.DateTime 或 System.Collections.Generic.List<string>。初始化及后续赋值会检查实际值是否可赋给目标类型,不做隐式转换:int 接受整数 123,不接受文本 "123" 或 long 值。检查失败时保留原值并提示变量名和实际类型。

  • 空默认值使用 default(T);引用类型及可空类型可以为 null,非可空值类型不能被赋为 null。
  • 默认值以 $= 开头时按表达式计算,其它文本仍是字符串。初始化按变量声明顺序进行,只能引用已初始化的变量。
  • 编辑时允许保存语法合法但本机缺少依赖的类型;运行时无法解析该类型会报错,不会自动退回动态对象。
  • 指定类型不支持状态保存,也不能生成 V1 分享制品。含此类变量的主程序或子程序请使用新版 V2 运行。

“动态对象”的可选 C# 类型只用于补全提示,不限制或转换运行时的值。需要接受任意对象时仍选动态对象,不要仅为补全提示改成指定类型。

在步骤窗口中编辑变量​

2.2.11 起,步骤编辑窗口的变量菜单可以直接新增或编辑变量;空列表会直接进入创建。改名会同步更新所属程序的引用,包括局部子程序。只读视图可查看已有定义,不能创建或保存。

变量修改单独确认:已经确认的变量修改,不会因随后取消步骤编辑而撤销。请在变量窗口确认名称、类型和影响后再保存。

创建和编辑​

点列表上的 + ,或在步骤参数窗里点「创建变量」。双击变量名或点铅笔可编辑。

变量名:唯一标识,中英文都可以,不要空格和特殊字符。不要用纯数字。复杂动作可用 前缀_名字 方便分组。

插值时按变量顺序替换。不要让前面变量替换后刚好变成 {后面的变量名},否则会被再次替换。

类型、备注、默认值:类型决定能存什么;备注给自己看;默认值是动作开始时的初值。1.12 之后默认值也可以写表达式,但尽量别引用其它变量,更不要引用后面才定义的变量。

作为状态使用:动作正常结束后把值存进动作,下次运行再读回来。状态键是 $var:变量名。长期挂着、不会正常结束的动作不要勾这项,值可能写不回去。详见 状态存取。

默认值写法​

类型写法示例
文本直接写,可多行你好,欢迎使用 Quicker!
图片不支持默认值—
布尔true / 1 为真,false / 0 为假true
数字小数234.56
数字(整数)整数123
日期时间日期,或表示相对今天的天数2019-4-1 12:30:00 或 5
列表每行一项北京 / 上海
词典每行 键:值,或 json:{...}China:中国
对象任意 C# 对象,在表达式里调方法—

限制与排障​

  • 名字含空格或纯数字时,插值和表达式会解析失败。
  • 勾了「作为状态使用」却一直不结束动作,下次运行仍是默认值。
  • 列表、词典、表格、对象的专门规则见各子页。

相关链接​

更新于