全部产品

rpa.ctrl_visitor

更新时间:2020-03-03 16:09:23

版本要求:客户端在3.3.28及以上

目录

rpa.ctrl_visitor

提供在运行时动态修改控件树的一组方法
注意:所有的控件树变更都只在运行时有效,并不会真正的修改应用数据(不会持久化变更信息)

add


方法名:
add(self, name, value)

方法描述:
该方法会在控件树中添加一个新控件
版本信息:
该方法适用于从3.3.28及以上版本。

参数说明:

  • value : 控件元对象
  • name : 控件名称

返回值说明:

示例:

  1. raw = {'type': 'text', 'classname': 's_ipt', 'id': 'kw', 'name': 'wd', 'tag': 'INPUT', 'ControlType': 'IE'}
  2. rpa.ctrl_visitor.add('new_input', raw) # 添加一个名词为new_input的控件
  3. page = rpa.ie.create('www.baidu.com')
  4. page.input('new_input', 'Alibaba') # 使用new_input控件

get


方法名:
get(self, name)

方法描述:
根据控件名称获取控件元对象,
版本信息:
该方法适用于从3.3.28及以上版本。

参数说明:

  • name : 控件名称

返回值说明:
返回dict类型

示例:

  1. raw = rpa.ctrl_visitor.get('输入框')

remove

方法名:
remove(self, name)

方法描述:
根据控件名称删除控件
版本信息:
该方法适用于从3.3.28及以上版本。

参数说明:

  • name : 控件名称

返回值说明:

示例:

  1. rpa.ctrl_visitor.remove('输入框')
  2. page = rpa.ie.create('www.baidu.com')
  3. page.input('输入框', 'Alibaba') # raise SDKError, 指定控件不存在

update


方法名:
update(self, name, value)

方法描述:
更新指定控件的元数据
版本信息:
该方法适用于从3.3.28及以上版本。

参数说明:

  • name : 控件名称
  • value : 控件元对象

返回值说明:

示例:

  1. page = rpa.ie.create('www.baidu.com')
  2. raw = rpa.ctrl_visitor.get('输入框')
  3. raw['classname'] = raw['classname'].replace('nobg_s_fm_hover', '').strip() # 移除'nobg_s_fm_hover'
  4. rpa.ctrl_visitor.update('输入框', raw)
  5. page.input('输入框', "Alibaba")