界面操作

对软件界面元素和操作系统界面元素进行操作。

软件元素和操作系统元素通过路径数组（以json字符串表示）进行表示，通过捕获元素按钮捕获后，都会对元素生成一个元素路径，如下图：

焦点定位

将焦点定位到目标元素，如文本输入框、按钮等元素获取焦点。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

获取输入框内容

获取文本输入框内的内容，如下图所示元素：

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	string	输入框内容

填写输入框内容

将指定内容填写到目标输入框中。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获
元素值	string	是	填写到输入框的内容

输出参数：

无

填写密码框内容

填写密码框内容,在设置时会将密码隐藏，防止泄密，如下图：

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获
密码	string	是	填写到输入框的密码

输出参数：

无

选择下拉框内容

设置下拉框选中指定值，下拉框为类似下图所示元素：

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获
元素值	string	是	下拉框的选中值

输出参数：

无

获取下拉框内容

获取下拉框的选中的内容。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	string	下拉框选中的内容

选择勾选框

勾选单选框或者复选框，勾选框为类似下图所示元素。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

获取勾选框状态

获取单选框或复选框状态，是否选中。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	bool	true:选中，false:未选中

获取元素文本

获取目标元素的显示文本，如下图所示的文本，都可以通过该方法获取。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	string	元素文本

单击元素

模拟鼠标点击元素，一般用于点击按钮类型元素，如下图。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

右击元素

模拟鼠标右击元素。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

双击元素

模拟鼠标双击元素。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

展开元素

展开元素，一般用树形结构元素，如下图：

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

折叠元素

折叠元素，将展开的元素折叠。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

滚动元素

滚动元素，元素一般为面板元素且带有滚轮，如下图所示元素：

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

无

提示

在进行元素定位时，应该定位左边红框内元素，而不是右侧的滚轮。

等待元素出现

等待目标元素出现，一般用于新打开界面的元素。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获
超时时间	int	是	等待元素的最大等待时间，单位:秒，如果超过，则抛出等待超时异常

输出参数：

变量名	类型	说明
自定义	bool	等待结果,true:表示出现，false:表示未出现

等待元素消失

等待目标元素消失，一般用于已经关闭的页面元素。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获
超时时间	int	是	等待元素的最大等待时间，单位秒，如果超过，则抛出等待超时异常

输出参数：

变量名	类型	说明
自定义	bool	等待结果,true:表示消失，false:表示未消失

元素截图

对选中元素进行截图。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获
保存路径	string	是	截图保存路径

输出参数：

无

元素是否存在

判断指定元素是否存在。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	bool	元素是否存在,true:表示存在，false:表示不存在

获取子元素

获取指定元素的直接子元素。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	List<AutomationElement>	子元素数组

获取父元素

获取指定元素的直接父元素。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	AutomationElement	父元素

获取兄弟元素（含自己）

获取指定元素的兄弟元素，包含自己。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	List<AutomationElement>	兄弟元素数组

获取元素中心坐标

获取元素中心点相对于屏幕的坐标。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获

输出参数：

变量名	类型	说明
自定义	string	包含坐标信息的json字符串，如：{"X":342, "Y":457}

点击元素内坐标

点击元素内的指定坐标位置，坐标为相对于指定元素左上角的坐标。

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获
点击位置	string	是	点击坐标，通过选择按钮进行定位
操作类型	string	是	点击类型

输出参数：

变量名	类型	说明
自定义	string	真实点击坐标（相对于屏幕），如：{"X":342, "Y":457}

获取相似元素

根据指定的两个元素获取所有相似元素。相似元素指拥有相同祖先节点，元素类型相同且元素路径相似的元素，如下面两个元素。

元素	元素路径（xpath）
元素1	/Pane[@name="Program Manager"]/Pane[1]/List[1]/ListItem[55]
元素2	/Pane[@name="Program Manager"]/Pane[1]/List[1]/ListItem[50]

输入参数：

参数名	类型	是否必须	说明
A元素	string	是	元素定位路径，通过选择按钮进行捕获
B元素	string	是	元素定位路径，通过选择按钮进行捕获

输出参数：

变量名	类型	说明
自定义	List<string>	所有相似元素的路径集合

Xpath转元素

将string类型的xpath转换成AutomationElement元素对象，转换成对象以后，就可以对使用元素操作下的所有方法。

输入参数：

参数名	类型	是否必须	说明
xpath	string	是	元素xpath，如：/Pane[@name="Program Manager"]/Pane[1]/List[1]/ListItem[50]

输出参数：

变量名	类型	说明
自定义	AutomationElement	转换后的AutomationElement对象

提示

在使用输出的AutomationElement对象时，元素来源应选择变量输入，如下图：

点击元素坐标

点击元素内指定坐标

输入参数：

参数名	类型	是否必须	说明
元素路径	string	是	元素定位路径，通过捕获元素按钮进行捕获
横向偏移	int	是	元素内x轴偏移，元素左上角为原点
纵向偏移	int	是	元素内y轴偏移，元素左上角为原点
操作类型	string	是	对指定坐标的操作类型

输出参数：

变量名	类型	说明
自定义	string	真实点击坐标（相对于屏幕），如：{"X":342, "Y":457}