F(x)

catch

catch(title, mode='start', process_name=None, class_name=None, timeout=10)

方法描述

根据标题捕获窗口对象

参数说明

title<str>窗口标题

mode<str>窗口匹配模式

可选项:

  • start : 头匹配

  • substr : 包含

  • exact : 完全匹配

  • reg : 正则表达式匹配

process_name<str>进程名称

class_name<str>窗口类名

timeout<int>等待窗口超时时间 单位秒

返回值说明

返回窗口对象<JavaWindow>

调用样例- rpa.ui.java.catch-

# 注意事项:无
# 代码调用样例如下:
java_wnd = rpa.ui.java.catch("Pycharm",mode="substr")

get_element_by_name

get_element_by_name(element, index=1, parent_element=None, timeout=10)

方法描述

根据控件名获取控件对象

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回控件对象<Element>

调用样例- rpa.ui.java.get_element_by_name-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
java_elem = rpa.ui.java.get_element_by_name("JAVA控件")

elem_count

elem_count(element, parent_element=None, timeout=10)

方法描述

获取控件个数

参数说明

element<str>控件名

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回控件个数<int>

调用样例- rpa.ui.java.elem_count-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
count = rpa.ui.java.get_elem_count("JAVA控件")

elem_wait_loaded

elem_wait_loaded(element, index=1, timeout=10)

方法描述

等待加载控件,成功返回True,失败返回False

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

timeout<int>等待控件超时时间 单位秒

返回值说明

返回是否加载成功<bool>

调用样例- rpa.ui.java.elem_wait_loaded-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
flag = rpa.ui.java.elem_wait_loaded("JAVA控件")

elem_input_text

elem_input_text(element, value, index=1, parent_element=None, simulate=True, replace=True, send_window_message=False, sent_raw=False, wait_mili_seconds=20, timeout=10)

方法描述

向控件输入文本

参数说明

element<str>控件名

value<str>输入的内容

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

simulate<bool>是否模拟输入

replace<bool>是否清空之前的内容

send_window_message<bool>是否发送Windows消息

sent_raw<bool>是否发送原始按键

wait_mili_seconds<int>字符间输入间隔(毫秒),仅在模拟输入下有效,默认值为20,最大值100,该值设置过大可能会引起超时

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_input_text-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_input_text("JAVA控件","RPA_测试")

elem_input_hotkeys

elem_input_hotkeys(element, value, index=1, parent_element=None, timeout=10)

方法描述

向控件输入快捷键

参数说明

element<str>控件名

value<str>输入的内容

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_input_hotkeys-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_input_hotkeys("JAVA控件","VK_BACK")

elem_click

elem_click(element, index=1, simulate=True, send_window_message=False, button='left', offset_x=0, offset_y=0, parent_element=None, timeout=10)

方法描述

点击控件

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

simulate<bool>是否模拟点击

send_window_message<bool>是否发送Windows消息

offset_x<int>横向偏移量

offset_y<int>纵向偏移量

button<str>鼠标键位

可选项:

  • left : 左键

  • right : 右键

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_click-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_click("JAVA控件")

elem_double_click

elem_double_click(element, offset_x=0, offset_y=0, index=1, parent_element=None, timeout=10)

方法描述

双击控件

参数说明

element<str>控件名

offset_x<int>横向偏移量

offset_y<int>纵向偏移量

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_double_click-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_double_click("JAVA控件")

elem_expand

elem_expand(element, index=1, parent_element=None, timeout=10)

方法描述

控件节点展开

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_expand-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_expand("JAVA控件")

elem_collapse

elem_collapse(element, index=1, parent_element=None, timeout=10)

方法描述

控件节点折叠

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_collapse-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_collapse("JAVA控件")

elem_set_selected_item_by_index

elem_set_selected_item_by_index(element, item_index, index=1, parent_element=None, timeout=10)

方法描述

combobox--根据指定下标选中下拉列表中的项

参数说明

element<str>控件名

item_index<int>选项下标

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_set_selected_item_by_index-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_set_selected_item_by_index("JAVA控件",2)

elem_set_selected_item_by_text

elem_set_selected_item_by_text(element, text, index=1, parent_element=None, timeout=10)

方法描述

combobox--根据指定文本选中下拉列表中的项

参数说明

element<str>控件名

text<str>选项文本

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_set_selected_item_by_text-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_set_selected_item_by_text("JAVA控件","下拉选项")

elem_get_selected_items

elem_get_selected_items(element, mode='all', index=1, parent_element=None, timeout=10)

方法描述

获取combobox的所有选项或者所有选中的选项

参数说明

element<str>控件名

mode<str>选择模式

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回item的数组<list>

调用样例- rpa.ui.java.elem_get_selected_items-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
option_list = rpa.ui.java.elem_get_selected_items("JAVA控件")

elem_set_checked_state

elem_set_checked_state(element, value=True, index=1, parent_element=None, timeout=10)

方法描述

设置复选框状态

参数说明

element<str>控件名

value<bool>是否勾选

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_set_checked_state-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_set_checked_state("JAVA控件",value=False)

elem_get_checked_state

elem_get_checked_state(element, index=1, parent_element=None, timeout=10)

方法描述

获取复选框状态

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回复选框的状态<bool>

调用样例- rpa.ui.java.elem_get_checked_state-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
state = rpa.ui.java.elem_get_checked_state("JAVA控件")

get_selected

get_selected(element, index=1, parent_element=None, timeout=10)

方法描述

获取选中状态

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回是否选中<bool>

调用样例- rpa.ui.java.get_selected-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
selected_flag = rpa.ui.java.get_selected("JAVA控件")

elem_text

elem_text(element, index=1, parent_element=None, timeout=10)

方法描述

获取控件中的文本

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回文本<str>

调用样例- rpa.ui.java.elem_text-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
text = rpa.ui.java.elem_text("JAVA控件")

elem_value

elem_value(element, index=1, parent_element=None, timeout=10)

方法描述

获取控件中的值

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回控件中的值<str>

调用样例- rpa.ui.java.elem_value-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
value = rpa.ui.java.elem_value("JAVA控件")

elem_pos

elem_pos(element, index=1, parent_element=None, timeout=10)

方法描述

获取控件坐标

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回坐标{x1,y1,x2,y2}<dict>

调用样例- rpa.ui.java.elem_pos-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
pos_dict = rpa.ui.java.elem_pos("JAVA控件")

elem_table

elem_table(element, index=1, parent_element=None, timeout=10)

方法描述

获取控件表格内容

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

返回值说明

返回表格内容<list>

调用样例- rpa.ui.java.elem_table-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
table_data = rpa.ui.java.elem_table("JAVA控件")

elem_screenshot

elem_screenshot(element, file, index=1, parent_element=None, timeout=10)

方法描述

控件截图

参数说明

element<str>控件名

file<str>保存截图完成路径(含文件名)

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_screenshot-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
path = r"D:\2_测试文件归档\java控件截图.jpg"
rpa.ui.java.elem_screenshot("JAVA控件",path)

elem_mouse_move

elem_mouse_move(element, index=1, parent_element=None, timeout=10)

方法描述

鼠标移入控件

参数说明

element<str>控件名

index<int>如果有多个,给出控件下标

parent_element<Element>父控件对象

timeout<int>等待控件超时时间 单位秒

调用样例- rpa.ui.java.elem_mouse_move-

# 注意事项:
# 使用此方法前请先通过捕捉控件功能捕捉对应控件元素
# 代码调用样例如下:
rpa.ui.java.elem_mouse_move("JAVA控件")

阿里云首页 机器人流程自动化RPA 相关技术圈