概述

显示一个可以同时修改多个变量的表单窗口。如下图所示：
image.png

表单的每一行称为一个“字段”。每个字段用于修改一个变量的值或词典变量的某个键的值。
表单显示的时候，会自动加载变量的当前值。表单保存后将输入的值写入到变量中。

工作模式

【编辑动作变量的值】
用于编辑动作的某一些变量的值。显示表单时，会自动加载变量的当前值。表单保存后，会将修改后的值保存到变量。通常用于结合“作为状态使用”的变量，为动作创建设置界面。

【编辑词典数据】（自1.34.5版本增加。）
用于修改词典变量的内部数据（某些键所对应的值）。
image.png

【编辑词典数据（动态）】
在动作运行期间生动态成表单定义。
image.png

使用

键盘使用：

  • Tab：跳转到下个控件
  • Shift+Tab：跳转到上个控件
  • Ctrl+Tab 或 Ctrl+↓：跳转到下一个字段
  • Ctrl+↑：跳转到上一个字段
  • Alt+S：保存
  • Alt+C、Esc：取消
  • Alt+R：重置表单内容

参数

image.png

【工作模式】选择用途：编辑变量，还是编辑某个词典的数据。
【词典变量】工作模式为“编辑词典数据”时，指定需要被编辑数据的词典类型变量。

【窗口标题】表单窗口的标题文字。
【表单定义】打开表单定义窗口设计表单。动态表单的数据定义格式请参考本文下面部分的章节。

【提示文字】显示在表单下方的提示文字。
【标题列宽度】设置表单文本标题部分所占宽度。
image.png
【窗口宽度】表单窗口的整体宽度。
【置顶显示】是否自动置顶表单窗口。
【恢复活动窗口】在表单关闭后，是否将输入焦点恢复到显示表单之前的窗口上。
【取消后停止】取消表单后，是否停止动作的后续步骤。

设计表单

image.png

在步骤设置中，点击“编辑表单”按钮，即可打开表单编辑器窗口。

image.png

在此窗口中设定需要通过表单修改哪些变量的值（或词典键对应的值），以及输入方式、验证条件等信息。

表单设计窗口列出了所有的字段。
点击“添加字段”按钮，添加新的字段：

image.png

【动作变量】工作模式为“编辑动作变量的值”时，设定要编辑的变量名。

【词典的键名】工作模式为“编辑词典数据”时，指定要编辑词典的哪个键(key)对应的值。
【数据类型】工作模式为“编辑词典数据”时，指定词典键所对应的值的数据类型。例子：加入某个存储用户信息的词典，有“姓名”和“年龄”两个键，则它们对应的数据类型分别为 文本 和 数字。

image.png
【字段标题】显示在表单左侧的字段名称。
【帮助提示】显示在输入框下方的提示文字。
【分组】字段较多时，可以按逻辑关联将某些字段放置在分组中。
可以在字段列表中选中多项，然后通过右键菜单快速修改分组。
image.png

【输入方式】设定使用哪种控件编辑值。
【验证表达式】输入方式为文本框时，对输入内容进行校验的正则表达式。
【最大长度】允许输入的最多字符数。
【数值范围】输入内容的最小值和最大值（可选）。
【文本选择工具】在输入框右侧显示的快捷选择按钮。
【可见性表达式】依据某些‘检查框’和‘下拉框’方式输入的字段值，更新当前字段的可见性。

  • 操作类型为“编辑动作变量的值”时，可见性表达式中可以使用当前主程序或子程序的其它变量。如$= {铃声模式变量} == "自定义"中，铃声模式变量为另外一个变量。
  • 操作类型为“编辑词典数据”时，可见性表达式中可以将其它词典键当做变量访问。如$= {铃声模式}.ToString()=="自定义"中，铃声模式为当前被编辑词典的另外一个键。

【不能为空】是否必须输入内容。

双击或点击后面的编辑按钮按钮可以修改字段。

动态表单定义数据

示例动作：动态表单示例

image.png

表单定义的输入为Quicker.Public.Forms.FormField对象列表的JSON数据格式。 也可以直接通过表达式返回Quicker.Public.Forms.FormField对象的列表，此时会自动生成json数据。

注意：动态表单因为无法进行事先的校验和数据限制，需要动作开发者自行保证数据合法、词典值的类型和输入方式匹配。

FormField类型的定义如下：

  2. namespace Quicker.Public.Forms
  3. {
  4.     /// <summary>
  5.     /// 表单字段
  6.     /// </summary>
  7.     public class FormField
  8.     {     
  10.         /// <summary>
  11.         /// 对应的变量
  12.         /// </summary>
  13.         public string FieldKey { get; set; }
  15.         /// <summary>
  16.         /// 对于编辑词典键值的情况，设定类型
  17.         /// </summary>
  18.         public VarType? DictVarType { get; set; }
  20.         /// <summary>
  21.         /// 字段名、标签
  22.         /// </summary>
  23.         public string Label { get; set; }
  25.         /// <summary>
  26.         /// 帮助文本
  27.         /// </summary>
  28.         public string HelpText { get; set; }
  30.         /// <summary>
  31.         /// 帮助链接
  32.         /// </summary>
  33.         public string HelpLink { get; set; }
  35.         /// <summary>
  36.         /// 输入方法
  37.         /// </summary>
  38.         public InputMethod InputMethod { get; set; }
  40.         /// <summary>
  41.         /// 选项内容。使用换行分隔多条。
  42.         /// </summary>
  43.         public string SelectionItems { get; set; }
  45.         /// <summary>
  46.         /// 是否必填
  47.         /// </summary>
  48.         public bool IsRequired { get; set; }
  50.         /// <summary>
  51.         /// 最小值
  52.         /// </summary>
  53.         public string MinValue { get; set; }
  55.         /// <summary>
  56.         /// 最大值
  57.         /// </summary>
  58.         public string MaxValue { get; set; }
  60.         /// <summary>
  61.         /// 验证规则表达式
  62.         /// </summary>
  63.         public string Pattern { get; set; }
  65.         /// <summary>
  66.         /// 最大长度
  67.         /// </summary>
  68.         public int MaxLength { get; set; } = 0;
  70.         /// <summary>
  71.         /// 输入法状态控制
  72.         /// </summary>
  73.         public string ImeState { get; set; }
  75.         /// <summary>
  76.         /// 文本选择工具：以英文半角逗号分隔的工具名。
  77.         /// </summary>
  78.         public string TextTools { get; set; }
  80.         /// <summary>
  81.         /// 可见性表达式
  82.         /// </summary>
  83.         public string VisibleExpression { get; set; }
  85.         /// <summary>
  86.         /// 分组名称
  87.         /// </summary>
  88.         public string Group { get; set; }
  90.     }
  91. }

其中，VarType的定义为（已去除一些在表单中不支持的类型，在Json中写对应的数字值）：

  1. namespace Quicker.Public.Actions
  2. {
  3.     /// <summary>
  4.     /// 参数类型
  5.     /// </summary>
  6.     public enum VarType
  7.     {
  8.         /// <summary>
  9.         /// 文本
  10.         /// </summary>
  11.         [Display(Name = "文本", Order = 10)]
  12.         Text = 0, //文本
  14.         /// <summary>
  15.         /// 数字（小数）
  16.         /// </summary>
  17.         [Display(Name = "数字(小数)", Order = 2)]
  18.         Number = 1, // 数字
  20.         /// <summary>
  21.         /// 数字（整数）
  22.         /// </summary>
  23.         [Display(Name = "数字(整数)", Order = 3)]
  24.         Integer = 12, //整数
  26.         /// <summary>
  27.         /// 布尔(是否)
  28.         /// </summary>
  29.         [Display(Name = "布尔(是否)", Order = 1)]
  30.         Boolean = 2, //布尔
  33.         /// <summary>
  34.         /// 文本列表
  35.         /// </summary>
  36.         [Display(Name = "文本列表", Order = 21)]
  37.         List = 4, //字符串列表
  40.         /// <summary>
  41.         /// 时间日期
  42.         /// </summary>
  43.         [Display(Name = "时间日期", Order = 11)]
  44.         DateTime = 6, //日期时间
  45.     }
  48. }

InputMethod的定义（已去除一些在表单中不支持的类型，在Json中写对应的数字值）：

  1. namespace Quicker.Public.Forms
  2. {
  3.     /// <summary>
  4.     /// 输入方式
  5.     /// </summary>
  6.     public enum InputMethod
  7.     {
  8.         /// <summary>
  9.         /// -无-
  10.         /// </summary>
  11.         [Display(Name = "-无-")]
  12.         None = 0,
  14.         /// <summary>
  15.         /// 单行文本框
  16.         /// </summary>
  17.         [Display(Name = "单行文本框")]
  18.         TextBox=1,
  20.         /// <summary>
  21.         /// 多行文本框
  22.         /// </summary>
  23.         [Display(Name = "多行文本框")]
  24.         TextEditor = 2,
  26.         /// <summary>
  27.         /// 下拉选择框
  28.         /// </summary>
  29.         [Display(Name = "下拉选择")]
  30.         DropDown = 3,
  32.         /// <summary>
  33.         /// 滑块
  34.         /// </summary>
  35.         [Display(Name = "滑块")]
  36.         Slider = 4,
  38.         /// <summary>
  39.         /// 日期选择框
  40.         /// </summary>
  41.         [Display(Name = "日期选择")]
  42.         DatePicker = 5,
  44.         /// <summary>
  45.         /// 检查框
  46.         /// </summary>
  47.         [Display(Name = "检查框")]
  48.         CheckBox = 6,
  50.         /// <summary>
  51.         /// 数字输入框
  52.         /// </summary>
  53.         [Display(Name = "数字输入框")]
  54.         NumberBox = 7,
  56.         /// <summary>
  57.         /// 多选下拉框
  58.         /// </summary>
  59.         [Display(Name = "多选下拉框")]
  60.         CheckComboBox = 8,
  62.         /// <summary>
  63.         /// 颜色选择框
  64.         /// </summary>
  65.         [Display(Name = "颜色选择器")]
  66.         ColorPicker = 9,
  68.         /// <summary>
  69.         /// 密码框
  70.         /// </summary>
  71.         [Display(Name = "密码框")]
  72.         PasswordBox = 10,
  74.         /// <summary>
  75.         /// 带选择的文本框
  76.         /// </summary>
  77.         [Display(Name = "带选择的文本框")]
  78.         EditableDropDown = 11,
  80.         /// <summary>
  81.         /// 字体选择器
  82.         /// </summary>
  83.         [Display(Name = "字体选择器")]
  84.         FontFamilySelector = 12,
  86.         /// <summary>
  87.         /// 带选择的文本框(支持选项筛选)
  88.         /// </summary>
  89.         [Display(Name = "带选择的文本框(支持选项筛选)")]
  90.         EditableAutoCompleteDropDown = 13,
  93.         [Display(Name = "分隔线")]
  94.         Separator = 100
  95.     }
  96. }

文本选择工具，Json中为以英文半角逗号分隔的工具名，如EditInCodeWindow,SelectProcessPath，可选值如下：

  1. namespace Quicker.Modules.TextTools
  2. {
  3.     /// <summary>
  4.     /// 输入框工具类型
  5.     /// </summary>
  6.     public enum TextToolType
  7.     {
  8.         Na, //不支持的选项
  10.         [Display(Name = "在代码窗口中编辑")]
  11.         EditInCodeWindow, //在代码窗口中编辑
  13.         [Display(Name = "选择一个文件")]
  14.         SelectSingleFile, //选择一个文件的路径
  16.         [Display(Name = "选择多个文件")]
  17.         SelectMultiFile, //选择多个文件路径
  19.         [Display(Name = "选择文件夹")]
  20.         SelectSingleFolder, //选择一个文件夹
  21.         //SelectMultipleFolder, //选择多个文件夹
  23.         [Display(Name = "选择窗口并获取进程的路径")]
  24.         SelectProcessPath, //选择进程的完整路径
  26.         [Display(Name = "选择窗口并获取进程名称")]
  27.         SelectProcessName, //选择进程名称
  29.         [Display(Name = "选择窗口并获取标题")]
  30.         SelectWindowTitle, //选择窗口名称
  32.         [Display(Name = "选择窗口并获取其类名")]
  33.         SelectWindowClass, //选择窗口类
  35.         [Display(Name = "选择屏幕位置")]
  36.         SelectLocationPoint, //选择位置
  38.         [Display(Name = "选择屏幕区域")]
  39.         SelectLocationArea,     //选择区域
  41.         [Display(Name = "选择屏幕颜色")]
  42.         SelectColor,        //选择屏幕颜色
  44.         [Display(Name = "选择颜色(#RRGGBB)")]
  45.         ColorPicker,        //颜色选择器
  47.         [Display(Name = "选择颜色(#AARRGGBB)")]
  48.         ColorPickerArgb,        //颜色选择器
  50.         [Display(Name = "截图")]
  51.         CaptureToFile, //截图并保存到图片
  53.         [Display(Name = "选择图标")]
  54.         SelectIcon,         //选择图标
  58.         [Display(Name = "输入并获取键名")]
  59.         SelectKeyName,      // 按键名称（System.Windows.Forms.Keys)
  61.         [Display(Name = "输入并获取'模拟按键B'的值")]
  62.         SelectSendKeysData, // 选择模拟按键B的键值
  64.         [Display(Name = "输入并获取虚拟键码数字")]
  65.         SelectKeyCode, // 选择模拟按键B的键值
  67.         [Display(Name = "选择动作ID")]
  68.         SelectActionId,
  70.         [Display(Name = "选择动作名称")]
  71.         SelectActionName,
  73.         [Display(Name = "选择控件XPath")]
  74.         SelectControlXPath,
  76.         [Display(Name = "布尔表达式助手")]
  77.         BoolExpressionHelper,
  78.         //[Display(Name= "Wpf窗体设计器")]
  79.         //WindowDesigner,
  81.         [Display(Name = "选择保存路径")]
  82.         SelectSavePath, //选择一个文件夹
  84.         [Display(Name = "选择窗口句柄")]
  85.         SelectWindowHandle, //选择窗口句柄
  86.     }
  87. }

更新历史

  • 1.5.7 增加提示文字参数。
  • 1.34.5 增加分组、编辑词典内容等功能。