展开树

根据输入的节点来展开“树形视图”控件。 在计算中，树形视图是图形界面元素，允许用户以树的形式显示分层数据，展开或折叠分支和节点。

语法

expandTree --path(String) [--delay(TimeSpan)] [--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)]

输入参数

下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。

设计器方式标签 脚本方式名称 必需的 接受的变量类型 Description
路径 path Required Text 要扩展的树形视图中的路径，使用换行符分隔每个节点。
延迟 delay Optional Time Span, Number, Text 每个树形视图节点展开之间的延迟时间。
更新屏幕高速缓存 forcerefresh Optional Boolean 启用以在运行命令之前再次读取屏幕。 使用它来识别新元素并更新屏幕高速缓存。

**注：**如果屏幕频繁更改，那么需要执行此操作。
选择器 selector Required ControlSelectors 用于识别用户界面控件的选择器的类型。 请参阅 selector 参数选项 以获取更多信息。

注: 使用 IBM RPA Studio的记录器来映射控件并获取选择器。
标识 id Only when selector is Id, IdAndName Text “树形视图”控件的标识。
名称 name Only when selector is Name, NameAndValue, IdAndName, TypeAndName Text “树形视图”控件的名称。
文本 innertext Only when selector is InnerTextAndTag Text 树形视图控件的内部文本。
元素类型 tagname Only when selector is InnerTextAndTag Text 在其中展开树形视图的元素的类型。
XPath xpath Only when selector is XPATH Text 将转至树形视图控件的 XPath。
类 classname Only when selector is ClassAndValue, ClassName Text 树形视图控件的类。
元素值 elementvalue Only when selector is ClassAndValue, NameAndValue Text 在其中展开树形视图的元素的当前值。
类型 controltype Only when selector is TypeAndIndex, TypeAndName ControlTypes 树形视图的控件类型。
索引 index Only when selector is TypeAndIndex Number 控件索引。
控件 control Only when selector is Instance Control 控件实例。

注: 使用 搜索控制 命令来获取控件。
表中的元素 usetable Optional Boolean 启用后，将可以按列或行在表中查找元素。
按列搜索 searchbycolumn Optional Boolean 启用后，将通过列（而不是按行）访存元素。
列 searchcolumn Only when element in table is True Text 将从中获取元素的列的名称或编号。
值 searchvalue Only when search by column is True Text 用于在表中查找元素的值。
返回列 returncolumn Only when search by column is True Text 包含控件的列。
行 row Only when search by column is False Number 将查找元素的表行。
超时 timeout Optional Time Span, Number, Text 命令执行超时。

注： 如果在 timeout 参数中未定义任何值，那么执行将使用设置超时命令定义的上下文时间。 如果脚本未使用该命令，那么缺省时间为 5 秒。

selector 参数选项

下表显示了可用于 selector 输入参数的选项。 该表显示了在脚本方式下工作时的可用选项以及在设计器方式下的等效标签。

设计器方式标签 脚本方式名称 Description
类和值 ClassAndValue 根据类名和值属性与元素匹配。
类名 ClassName 浏览器中接口控件的类名。
标识 Id 根据"标识"属性值与元素匹配。
标识和名称 IdAndName 根据标识和名称属性值与元素匹配。
内部文本和控件类型 InnerTextAndTag 根据元素文本内容和标记名称属性值与元素匹配。
实例 Instance 控件实例
链接文本 LinkText 根据链接文本属性值与元素匹配。
名称 Name 根据"名称"属性值与元素匹配。
名称和值 NameAndValue 根据名称和值属性与元素匹配。
类型和索引 TypeAndIndex 浏览器界面的控件和索引的类型。
类型和名称 TypeAndName 属于浏览器的控件和名称的类型。
XPath XPath 根据 HTML 根中的 XML 路径与元素匹配。

controltype 参数选项

下表显示了可用于 controltype 输入参数的选项。 该表显示了在脚本方式下工作时的可用选项以及在设计器方式下的等效标签。

设计器方式标签 脚本方式名称 Description
按钮 Button 它与应用程序中的“按钮”控件匹配。
复选框 CheckBox 它与应用程序中的“复选框”控件匹配。
子窗口 ChildWindow 它与应用程序中的“子窗口”控件匹配。
组合框 ComboBox 它与应用程序中的“组合框”控件匹配。
常规 Generic 它与应用程序中的“常规”控件匹配。
Image Image 它与应用程序中的“图像”控件匹配。
标签 Label 它与应用程序中的“标签”控件匹配。
列表框 ListBox 它与应用程序中的“列表框”控件匹配。
菜单栏 MenuBar 它与应用程序中的“菜单栏”控件匹配。
菜单项 MenuItem 它与应用程序中的“菜单项”控件匹配。
进度条 ProgressBar 它与应用程序中的“进度条”控件匹配。
单选按钮 RadioButton 它与应用程序中的“单选按钮”控件匹配。
滚动条 ScrollBar 它与应用程序中的“滚动条”控件匹配。
滑块 Slider 它与应用程序中的“滑块”控件匹配。
微调器 Spinner 它与应用程序中的“微调器”控件匹配。
状态栏 StatusBar 它与应用程序中的“状态栏”控件匹配。
选项卡页面 TabPage 它与应用程序中的“选项卡页面”控件匹配。
选项卡面板 TabPanel 它与应用程序中的“选项卡面板”控件匹配。
表 Table 它与应用程序中的“表”控件匹配。
文本框 TextBox 它与应用程序中的“文本框”控件匹配。
树形视图 TreeView 它与应用程序中的“树形视图”控件匹配。
TreeTable TreeTable 它与应用程序中的“树表”控件匹配。
窗口 Window 它与应用程序中的“窗口”控件匹配。

示例

在以下情况下，将展开本地应用程序中的树形视图控件。

defVar --name applicationWindow --type Window
defVar --name executionSuccess --type Boolean
// Download the following file to execute the command.
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}
expandTree --path "Tree\r\nColors\r\nBlue\r\n" --delay 00:00:01 --selector "Id" --id treeView1
// Wait 1 second between the expansion of each node to make visualization easier.