单击值
动词：clickOnValue
在用户控制界面中，单击树形视图的指定值。
在计算中，树形视图是图形界面元素，允许用户以树的形式显示分层数据，可展开或折叠分支和节点。
语法
clickOnValue --value(String) [--forcerefresh(Boolean)] --selector(ControlSelectors) --id(String) --name(String) --innertext(String) --tagname(String) --xpath(String) --classname(String) --elementvalue(String) --controltype(Nullable<ControlTypes>) --index(Numeric) --control(Control) [--usetable(Boolean)] [--searchbycolumn(Boolean)] --searchcolumn(String) --searchvalue(String) --returncolumn(String) --row(Numeric) [--timeout(TimeSpan)]
输入
| 脚本 | 设计器 | 必需的 | AcceptedTypes | 描述 |
|---|---|---|---|---|
| --value | 值 | 必需的 | 文本 | 应在树形视图上单击的值，并用换行符分隔每个节点。 |
| --forcerefresh | 更新屏幕高速缓存 | 可选 | BOOLEAN | 启用后，将在执行命令之前执行屏幕的新读取，以识别新元素并更新屏幕高速缓存。要正确运行命令，必须进行此识别，以防屏幕上有任何更改。 |
| --selector | 选择器 | 必需的 | ControlSelectors | 用于识别用户界面控件的选择器的类型。 提供了以下选项：您可以使用 IBM RPA Studio 的记录器来映射控件，并获取“选择器”参数的必要信息。 还可以使用自动完成功能来添加命令。 在 IBM RPA Studio的主菜单中提供了记录器。 |
| --id | 标识 | 仅当“选择器”为“标识”或“标识和名称”时 | 文本 | 应单击的树形视图标识。 |
| --name | 名称 | 仅当“选择器”为“名称”、“名称和值”、“标识和名称”或“类型和名称”时 | 文本 | 应单击的树形视图的名称。 |
| --innertext | 文本 | 仅当“选择器”为“内部文本和标记”时 | 文本 | 应单击的树形视图内部文本。 |
| --tagname | 元素类型 | 仅当“选择器”为“内部文本和标记”时 | 文本 | 应单击的元素的类型。 |
| --xpath | XPath | 仅当“选择器”为“XPath”时 | 文本 | 将转至应单击的树形视图的 XPath。 |
| --classname | 类 | 仅当“选择器”为“类和值”或“类名”时 | 文本 | 应单击的树形视图类。 |
| --elementvalue | 元素值 | 仅当“选择器”为“类和值”或“名称和值”时 | 文本 | 应单击的元素的值。 |
| --controltype | 类型 | 仅当“选择器”为“类型和索引”或“类型和名称”时 | ControlTypes | 用于识别应单击的元素的控件的类型。 |
| --index | 索引 | 仅当“选择器”为“类型和索引”时 | 成员 | 应单击的元素的索引。 |
| --control | 控制 | 仅当“选择器”为“实例”时 | 控件 | 控件实例。使用命令搜索控件获取此变量。 |
| --usetable | 表中的元素 | 可选 | BOOLEAN | 启用后，将从表中搜索元素。 |
| --searchbycolumn | 按列搜索 | 可选 | BOOLEAN | 启用后，将在表的特定列中搜索元素。 |
| --searchcolumn | 列 | 仅当“表中的元素”为 True 时 | 文本 | 在其中搜索元素的列。 |
| --searchvalue | 值 | 仅当“按列搜索”为 True 时 | 文本 | 用于在表中搜索元素的值。 |
| --returncolumn | 返回列 | 仅当“按列搜索”为 True 时 | 文本 | 元素的控件所在的列。 |
| --row | 行 | 仅当“按列搜索”为 False 时 | 成员 | 从中获取元素的行号。如果启用了按列搜索，那么会忽略此参数。 |
| --timeout | Timeout | 可选 | 时间范围、数字、文本 | 执行命令的超时。如果在类型为超时值的参数中未定义任何值，那么执行将使用设置超时值命令定义的时间。 如果脚本未使用此命令，那么缺省时间为 5 秒。 |
示例
将打开一个具有树形视图的可执行程序，并可使用命令单击值单击树形视图中指定的值。
defVar --name applicationWindow --type Window
defVar --name executionSuccess --type Boolean
launchOrAttach --executablepath CSharpTestApp.exe --title Users applicationWindow=value executionSuccess=success
assert --message "Did not find the demo application!" --left "${executionSuccess}" --operator "Is_True"
focusWindow --window ${applicationWindow}
clickOnValue --value "Tree\r\nColors\r\nBlue" --selector "Id" --id treeView1
下载文件
要正确操作以上脚本，必须下载该文件并在启动或附加窗口命令的可执行文件路径参数中插入其路径。
备注
可以使用 IBM RPA Studio的记录器来获取以下信息: