Control

add(name, value, mode='json')

方法描述

添加控件

参数说明

name<str>控件名称

value<dict>控件元对象

mode<str>数据格式

可选项：

• json : json格式

• xml : xml格式

调用样例- rpa.ui.ctrl.add-

# 注意事项：
# 通过捕捉控件捕捉的控件信息记录在工程文件的.ctrl.json文件中
# 此方法并不会向json新增控件信息，仅仅只是在代码执行过程中临时新增控件
# 代码调用样例如下：
raw = r'<wnd x:tag="tab" title="百度一下，你就知道" /><chrome x:tag="input" id="kw" />'
rpa.ui.ctrl.add("新增控件测试",raw,mode="xml")

get(name, mode='json')

方法描述

获取控件元对象

参数说明

name<str>控件名称

mode<str>返回数据格式

可选项：

• json : 返回JSON格式

• xml : 返回xml格式

返回值说明

返回控件元对象<list>

调用样例- rpa.ui.ctrl.get-

# 注意事项：
# 使用此方法需要先通过捕捉控件功能捕捉对应控件
# 将mode参数指定为xml时，将返回字符串，字符串内容形式可参阅编辑控件窗口
# 代码调用样例如下：
beta = rpa.ui.ctrl.get("百度一下",mode="xml")

remove(name)

方法描述

删除控件

参数说明

name<str>控件名称

调用样例- rpa.ui.ctrl.remove-

# 注意事项：
# 通过捕捉控件捕捉的控件信息记录在工程文件的.ctrl.json文件中
# 此方法并不会删除json文件中的控件信息，仅仅只是在代码执行过程中将指定的控件禁用
# 代码调用样例如下：
rpa.ui.ctrl.remove("百度一下")

update(name, value, mode='json')

方法描述

更新控件

参数说明

name<str>控件名称

value<dict>控件元对象

mode<str>数据格式

可选项：

• json : json格式

• xml : xml格式

调用样例- rpa.ui.ctrl.update-

# 注意事项：
# 通过捕捉控件捕捉的控件信息记录在工程文件的.ctrl.json文件中
# 此方法并不会修改json文件中的控件信息，仅仅只是在代码执行过程中更新控件信息
# 代码调用样例如下，本例中先在chrome浏览器上捕捉了控件，然后通过此方法将控件浏览器信息改为ie：
page1 = rpa.app.chrome.create('www.baidu.com')
page1.input_text('百度一下', 'Alibaba-chrome')
​
raw_ie = r'<wnd x:tag="tab" title="百度一下，你就知道" /><ie x:tag="input" id="kw" />'
rpa.ui.ctrl.update("百度一下",raw_ie,mode="xml")
page2 = rpa.app.ie.create('www.baidu.com')
page2.input_text('百度一下', 'Alibaba')