全部产品
云市场
云游戏

rpa3.java

更新时间:2020-03-02 19:15:18

本文结尾有本文中使用的脚本以及录制的应用,操作的java页面

目录

java

在3.4.3及以上版本中我们提供了对java框架实现的Windows控件的录制能力

要使用java模块,需要使用rpa.win32

java模块是用来向用户提供一系列操作Windows控件的SDK,让用户通过简单的参数和方法调用来实现一些复杂的操作。

此文档默认已经安装java录制工具,如未安装,请点击,java录制,进行录制工具安装

catch

方法名
catch(title, *, mode=’start’, process_name: str = None, class_name: str = None, timeout=10)

方法描述
根据标题捕获窗口对象,复制窗口进程名和窗口类名可增加匹配效率和准确率,如果匹配到多个窗口会报错,返回Window对象

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • title : 窗口标题
  • process_name : 进程名称
  • class_name :窗口类名
  • mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’
    • subStr : 包含指定title的窗体
    • exact : 完全匹配指定title的窗体
    • reg : title正则匹配指定title的窗体
  • timeout : 等待超时时间

返回值说明
返回java窗口对象
示例

  1. import rpa3 as rpa # 使用V3引擎
  2. #捕捉窗口名为SQuirreL SQL Client snapshot-20190714_0016的窗口
  3. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')

get_element

方法名
get_element(element, *, index=1, parent_element=None,timeout=10)

方法描述
获取控件对象

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件对象
示例

  1. element = rpa.java.get_element("file")

element_count

方法名
get_element(element, *, index=1, parent_element=None,timeout=10)

方法描述
获取控件个数

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • parent_elemet : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件个数
示例

  1. count = rpa.java.element_count("file")

wait

方法名
wait(element, *, index=1, timeout=10)

方法描述
等待加载控件,成功返回True,失败返回False

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • parent_elemet : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件是否加载完成
示例

  1. rpa.java.click("file")
  2. rpa.java.wait("New Session Properties")
  3. rpa.java.click("New Session Properties")

input

方法名
input(element, value, *, index=1, simulate=True, parent_element=None, sendWindowMessage=False,replace=False,timeout=10)

方法描述
输入

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • value : 输入的内容
  • index : 如果有多个,给出控件下标
  • simulate : 是否模拟输入
  • parent_elemet : 父控件对象
  • timeout : 超时时间 单位秒
  • sendWindowMessage : 是否发送窗口提示信息
  • replace : 是否替换输入内容
  • timeout: 等待控件超时时间

返回值说明

示例

  1. rpa.win32.click("加号")
  2. rpa.java.input('name', value='java录制演示', simulate=True, replace=False, sendWindowMessage=True, sentRaw = True, index=1)

click

方法名
click(element, *, index=1, offsetX=0, offsetY=0,simulate=True, parent_element=None, timeout=10)

方法描述
点击

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • offsetX : 横向偏移量
  • offsetY : 纵向偏移量
  • parent_element : 父控件对象
  • button: ‘left’|’right’ 左键或右键
  • simulate : 是否模拟点击
  • timeout: 等待控件超时时间

返回值说明

示例

  1. #左键点击
  2. rpa.java.click("file")
  3. #左键点击
  4. rpa.java.click("file", button="left", index=2)
  5. #右键点击
  6. rpa.java.click("file", button="right", index=4)
  7. #偏移右键控件
  8. rpa.java.click("file", button="right", index=3, offsetX=50, offsetY=0)

double_click

方法名
double_click(element, *, offsetX=0,offsextY=0,index=1, simulate=True, parent_element=None, timeout=10)

方法描述
双击

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • offsetX : 横向偏移量
  • offsetY : 纵向偏移量
  • index : 如果有多个,给出控件下标
  • simulate : 是否模拟点击
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. # 双击
  2. rpa.win32.double_click("桌面快捷方式")

expand

方法名
expand(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
节点展开

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. rpa.java.expand('控件名称')

collapse

方法名
collapse(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
节点折叠

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. rpa.java.collapse('控件名称')

set_select_item_by_index

方法名
set_select_item_by_index(self, element, item_index: int, *, index=1, parent_element=None, timeout=10)

方法描述
combobox—根据下标下拉

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • item_index : 选项下标
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. rpa.java.click("file", index=1, offsetX=-10)
  2. rpa.java.click("New Session Properties")
  3. rpa.java.set_select_item_by_index('combobox控件', 2, index=1)

set_select_item_by_text

方法名
set_select_item_by_index(self, element, text: str, *, index=1, parent_element=None, timeout=10)

方法描述
combobox—根据内容下拉

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • text : 选项文本
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. rpa.java.click("file", index=1, offsetX=-10)
  2. rpa.java.click("New Session Properties")
  3. rpa.java.set_select_item_by_text('combobox控件', r'Left', index=1)

get_select_items

方法名
get_select_items(self, element, mode=’selected’, *, index=1, parent_element=None, timeout=10)

方法描述
获取combobox的item

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • mode : ‘selected’|’all’
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回combobox的item
示例

  1. rpa.java.click("file", index=1, offsetX=-10)
  2. rpa.java.click("New Session Properties")
  3. # 返回所有选项的集合
  4. rpa.java.get_select_items('combobox控件', mode='all', index=1)
  5. # 返回选中的值的集合(因为有多选的情况,统一返回集合)
  6. rpa.java.get_select_items('combobox控件', mode='selected', index=1)

set_checked

方法名
set_checked(self, element, value: bool, *, index=1, parent_element=None, timeout=10)

方法描述
设置复选框状态

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • value : 是否勾选
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. rpa.java.click("file", index=1, offsetX=-10)
  2. rpa.java.click("New Session Properties")
  3. rpa.java.click("Object Tree")
  4. #设置勾选
  5. rpa.java.set_checked("复选框", value=True)
  6. #取消勾选
  7. rpa.java.set_checked("复选框", value=False)

get_checked

方法名
get_checked(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取复选框状态

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回复选框状态
示例

  1. rpa.java.click("file", index=1, offsetX=-10)
  2. rpa.java.click("New Session Properties")
  3. rpa.java.click("Object Tree")
  4. data = rpa.java.get_checked("复选框")

get_selected

方法名
get_selected(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取选中状态

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回选中状态
示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. 控件对象 = java_obj.get_element("file", index=1)
  3. 控件对象.click()
  4. New_Session_Properties = java_obj.click("New Session Properties")
  5. java_obj1 = rpa.java.catch('New Session Properties', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  6. java_obj1.click("Code Completion")
  7. data = java_obj1.get_selected('获取选中状态', index=1)

text

方法名
text(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取控件文本内容

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件文本内容
示例

  1. data = rpa.java.text("file")

value

方法名
value(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取控件value属性的值

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称(按钮控件)
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件value属性的值
示例

  1. rpa.java.click("file", index=1, offsetX=-10)
  2. rpa.java.click("New Session Properties")
  3. rpa.java.click("Syntax")
  4. data = rpa.java.value("获取value")

pos

方法名
pos(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取控件相对坐标

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件相对坐标x,y
示例

  1. #pos
  2. data = rpa.java.pos("file")
  3. # {"x1":405,"y1":234,"x2":438,"y2":257}

table

方法名
table(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取表格内容

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件表格内容
示例

  1. rpa.java.click("file", index=4, offsetX=-10)
  2. rpa.java.click("Summary")
  3. data = rpa.java.table('table表格', index=1)

screenshot

方法名
screenshot(self, element, file, *, index=1, parent_element=None, timeout=10)

方法描述
控件截图

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • file : 保存截图完成路径(含文件名)
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. # screenshot
  2. sleep(1)
  3. rpa.java.screenshot("file", file=r"C:\Users\Desktop\1.jpg", index=4)

mouse_move

方法名
mouse_move(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
鼠标移入控件

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. # mouse_move
  2. rpa.java.mouse_move("file", index=4)

JavaWindow

JavaWindow: 负责为用户提供JavaWindow相关的一些操作
JavaWindow中的操作我们用 java_obj表示对象

activate

方法名
activate(self)

方法描述
激活java窗口

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

返回值说明

示例

  1. java_obj.activate()

maximize

方法名
maximize(self)

方法描述
最大化java窗口

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

返回值说明

示例

  1. java_obj.maximize()

minimize

方法名
minimize(self)

方法描述
最小化java窗口

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

返回值说明

示例

  1. java_obj.minimize()

hide

方法名
hide(self)

方法描述
隐藏java窗口

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

返回值说明

示例

  1. java_obj.hide()

show

方法名
show(self)

方法描述
显示java窗口

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

返回值说明

示例

  1. java_obj.show()

win_disappear

方法名
wait_disappear(self, timeout=30)

方法描述
等待java窗口消失

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • timeout: 等待控件超时时间

返回值说明

示例

  1. java_obj.wait_disappear()

close

方法名
close(self)

方法描述
关闭java窗口

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

返回值说明

示例

  1. java_obj.close()

get_element

方法名
get_element(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取控件对象

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件对象
示例

  1. import rpa3 as rpa # 使用V3引擎
  2. #捕捉窗口名为SQuirreL SQL Client snapshot-20190714_0016的窗口
  3. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  4. 控件对象 = java_obj.get_element('file')

element_count

方法名
element_count(self, element, *, parent_element=None)

方法描述
获取控件个数

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • parent_element : 父控件对象

返回值说明
返回控件个数
示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. 控件个数 = java_obj.element_count("file")
  3. for i in range(1, 控件个数+1):
  4. print(控件个数)
  5. 控件对象 = java_obj.get_element("file", index=i)
  6. print(控件对象.text())

wait

方法名
wait(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
等待加载控件,成功返回True,失败返回False

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件加载是否成功
示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. 控件对象 = java_obj.get_element("file", index=1)
  3. 控件对象.click()
  4. New_Session_Properties = java_obj.wait("New Session Properties")

input

方法名
input(self, element, value, *, simulate=False, replace=False, index=1, parent_element=None, timeout=10)

方法描述
输入

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称(弹出框点击)
  • index : 如果有多个,给出控件下标
  • value : 输入的内容
  • parent_element : 父控件对象
  • simulate : 是否模拟输入
  • replace: 是否清空之前的内容
  • timeout: 等待控件超时时间

返回值说明

示例

  1. #模拟覆盖输入"aa"
  2. java_obj.input("控件名称", "aa", simulate=True, replace=True)
  3. #模拟追加输入"aa"
  4. java_obj.input("控件名称", "aa") #简略的写法
  5. java_obj.input("控件名称", "aa", simulate=True, replace=False)
  6. #非模拟覆盖输入"aa"
  7. java_obj.input("控件名称", "aa", simulate=False, replace=True)
  8. #非模拟追加输入"aa"
  9. java_obj.input("控件名称", "aa") #简略的写法
  10. java_obj.input("控件名称", "aa", simulate=False, replace=False)

click

方法名
click(self, element, *, button=’left’, simulate=True, offsetX=0, offsetY=0, index=1, parent_element=None, timeout=10)

方法描述
点击

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • offsetX : 横向偏移量
  • offsetY : 纵向偏移量
  • parent_element : 父控件对象
  • button: ‘left’|’right’ 左键或右键
  • simulate : 是否模拟点击
  • timeout: 等待控件超时时间

返回值说明

示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. #左键点击
  3. java_obj.click("file")
  4. #左键点击
  5. java_obj.click("file", button="left", index=2)
  6. #右键点击
  7. java_obj.click("file", button="right", index=4)
  8. #偏移右键控件
  9. java_obj.click("file", button="right", index=3, offsetX=50, offsetY=0)

double_click

方法名
double_click(self, element, *, offsetX=0, offsetY=0, index=1, parent_element=None, timeout=10)

方法描述
双击

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • offsetX : 横向偏移量
  • offsetY : 纵向偏移量
  • parent_element : 父控件对象
  • simulate : 是否模拟点击
  • timeout: 等待控件超时时间

返回值说明

示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. java_obj.click("file", index=1, offsetX=-10)
  3. New_Session_Properties = java_obj.click("New Session Properties")
  4. java_obj1 = rpa.java.catch('New Session Properties', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  5. java_obj1.click('Object Tree', button='left', simulate=True, sendWindowMessage=False, index=1, offsetX=0, offsetY=0)
  6. sleep(2)
  7. java_obj1.double_click("复选框")
  8. java_obj1.double_click("复选框", offsetX=-10, offsetY=0)

expand

方法名
expand(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
节点展开

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. java_obj.expand('控件名称')

collapse

方法名
collapse(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
节点折叠

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. java_obj.collapse('控件名称')

set_select_item_by_text

方法名
set_select_item_by_text(self, element, text: str, *, index=1, parent_element=None, timeout=10)

方法描述
combobox—根据内容下拉

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • text : 选项文本
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. #下拉第二个选项
  2. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  3. 控件对象 = java_obj.get_element("file", index=1)
  4. 控件对象.click()
  5. New_Session_Properties = java_obj.click("New Session Properties")
  6. java_obj1 = rpa.java.catch('New Session Properties', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  7. java_obj1.set_select_item_by_text('combobox控件', r'Left', index=1)

set_select_item_by_index

方法名
set_select_item_by_text(self, element, text: str, *, index=1, parent_element=None, timeout=10)

方法描述
combobox—根据下标下拉

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • item_index : 选项下标本
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. 控件对象 = java_obj.get_element("file", index=1)
  3. 控件对象.click()
  4. New_Session_Properties = java_obj.click("New Session Properties")
  5. java_obj1 = rpa.java.catch('New Session Properties', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  6. sleep(2)
  7. java_obj1.set_select_item_by_index('combobox控件', 2, index=1)

get_select_items

方法名
get_select_items(self, element, mode=’selected’, *, index=1, parent_element=None, timeout=10)

方法描述
获取combobox的item

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • mode : ‘selected’|’all’
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回combobox的item

示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. 控件对象 = java_obj.get_element("file", index=1)
  3. 控件对象.click()
  4. New_Session_Properties = java_obj.click("New Session Properties")
  5. java_obj1 = rpa.java.catch('New Session Properties', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  6. # 返回所有选项的集合
  7. all_list = java_obj.get_select_items('combobox控件', mode='all', index=1)
  8. # 返回选中的值的集合(因为有多选的情况,统一返回集合)
  9. all_list = java_obj.get_select_items('combobox控件', mode='selected', index=1)

set_checked

方法名
set_checked(self, element, value: bool, *, index=1, parent_element=None, timeout=10)

方法描述
设置复选框状态

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • value : 是否勾选
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. 控件对象 = java_obj.get_element("file", index=1)
  3. 控件对象.click()
  4. New_Session_Properties = java_obj.click("New Session Properties")
  5. java_obj1 = rpa.java.catch('New Session Properties', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  6. java_obj1.click('Object Tree', button='left', simulate=True, sendWindowMessage=False, index=1, offsetX=0, offsetY=0)
  7. #设置勾选
  8. java_obj1.set_checked('复选框', True, index=1)
  9. #取消勾选
  10. java_obj1.set_checked('复选框', False, index=1)

get_checked

方法名
get_checked(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取复选框状态

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回复选框状态
示例

  1. # get_checked
  2. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  3. 控件对象 = java_obj.get_element("file", index=1)
  4. 控件对象.click()
  5. New_Session_Properties = java_obj.click("New Session Properties")
  6. java_obj1 = rpa.java.catch('New Session Properties', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  7. java_obj1.click('Object Tree', button='left', simulate=True, sendWindowMessage=False, index=1, offsetX=0, offsetY=0)
  8. data = java_obj.get_checked('复选框', index=1)

get_selected

方法名
get_selected(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取选中状态

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回选中状态
示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. 控件对象 = java_obj.get_element("file", index=1)
  3. 控件对象.click()
  4. New_Session_Properties = java_obj.click("New Session Properties")
  5. java_obj1 = rpa.java.catch('New Session Properties', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  6. java_obj1.click("Code Completion")
  7. data = java_obj1.get_selected('获取选中状态', index=1)

text

方法名
text(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取控件文本内容

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件文本内容
示例

  1. # text
  2. # 方式一
  3. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  4. 控件对象 = java_obj.get_element("file", index=1)
  5. print(控件对象.text())
  6. # 方式二
  7. data = java_obj.text("file")

pos

方法名
pos(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取控件相对坐标

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件相对坐标x,y
示例

  1. #pos
  2. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  3. 控件对象 = java_obj.get_element("file", index=1)
  4. print(控件对象.pos())
  5. data = java_obj.pos("file")
  6. # {"x1":405,"y1":234,"x2":438,"y2":257}

table

方法名
table(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
获取表格内容

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明
返回控件表格内容
示例

  1. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  2. 控件对象 = java_obj.get_element("file", index=4)
  3. 控件对象.click()
  4. java_obj.click("Summary")
  5. java_obj1 = rpa.java.catch('SQuirreL SQL Client Plugin Summary', mode='exact', process_name='^javaw$', class_name='^SunAwtDialog$')
  6. table_data = java_obj1.table('table表格', index=1)
  7. # return: [['', 'codecompletion', 'SQL Entry Code Completion', 'true', '1.0', 'Gerd Wagner', 'Christian Sell'], ['', 'dataimport', 'Data Import Plugin', 'true', '1.0', 'Thorsten Mürell,Gerd Wagner', 'Guido Wojke,P_W999'], ['', 'dbcopy', 'DBCopy Plugin', 'true', '1.15', 'Rob Manning', 'Dan Dragut'], ['', 'dbdiff', 'DBDiff Plugin', 'true', '1.0', 'Rob Manning', ''], ['', 'graph', 'Graph', 'true', '2.0', 'Gerd Wagner', ''], ['', 'laf', 'Look & Feel Plugin', 'true', '1.1.1', 'Colin Bell', ''], ['', 'mssql', 'Microsoft SQL Server Assistant', 'true', '0.4', 'Ryan Walberg', 'Rob Manning'], ['', 'mysql', 'MySQL Plugin', 'true', '0.33', 'Colin Bell', ''], ['', 'oracle', 'Oracle Plugin', 'true', '0.21', 'Colin Bell', 'Alexander Buloichik, Rob Manning'], ['', 'refactoring', 'Refactoring Plugin', 'true', '1.0', 'Rob Manning', 'Daniel Regli, Yannick Winiger'], ['', 'sqlbookmark', 'SQL Bookmark Plugin', 'true', '2.0.1', 'Joseph Mocker', 'Gerd Wagner'], ['', 'sqlscript', 'SQL Scripts Plugin', 'true', '1.3', 'Johan Compagner', 'Gerd Wagner, John Murga, Rob Manning, Stefan Willinger'], ['', 'syntax', 'Syntax Highlighting Plugin', 'true', '1.0', 'Gerd Wagner, Colin Bell', '']]

screenshot

方法名
screenshot(self, element, file, *, index=1, parent_element=None, timeout=10)

方法描述
控件截图

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • file : 保存截图完成路径(含文件名)
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. # screenshot
  2. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  3. sleep(1)
  4. java_obj.screenshot("file", file=r"C:\Users\Desktop\1.jpg", index=4)

mouse_move

方法名
mouse_move(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
鼠标移入控件

版本信息
该方法适用于从3.4.2及以上版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_element : 父控件对象
  • timeout: 等待控件超时时间

返回值说明

示例

  1. # mouse_move
  2. java_obj = rpa.java.catch('SQuirreL SQL Client snapshot-20190714_0016', mode='exact', process_name='^javaw$', class_name='^SunAwtFrame$')
  3. sleep(1)
  4. java_obj.mouse_move("file", index=4)

案例

测试应用
java.7z
测试文件
SQuirrel.7z