Element

click(element, *, button='left', index=1, timeout=10)

方法描述

点击CV控件锚点位置

参数说明

element<str>控件名

button<str>鼠标键位

可选项：

• left：左键

• right：右键

index<int>控件序号，如果有多个，给出控件下标

timeout<int>查找控件的超时时间

调用样例 -rpa4.ai.cv.element.click-

# 注意事项：
# 1. 使用此方法前需要先通过捕捉控件功能捕捉对应cv类型控件
# 2. 执行时，需要确保控件所在的页面是打开状态
# 代码调用样例如下：
import rpa4.ai.cv as cv

cv.element.click('发消息按钮')
cv.element.click('用户头像')

double_click(element, *, index=1, timeout=10)

方法描述

双击CV控件锚点位置

参数说明

element<str>控件名

index<int>控件序号，如果有多个，给出控件下标

timeout<int>查找控件的超时时间

调用样例 -rpa4.ai.cv.element.double_click-

# 注意事项：
# 1. 使用此方法前需要先通过捕捉控件功能捕捉对应cv类型控件
# 2. 执行时，需要确保控件所在的页面是打开状态
# 代码调用样例如下：
import rpa4.ai.cv as cv

cv.element.double_click('文本框')

input_text(element, value, *, clear=True, index=1, wait_mili_seconds=20, timeout=10)

方法描述

在CV控件锚点位置输入文本

参数说明

element<str>控件名

value<str>待输入内容

clear<bool>输入前是否清除文本框内容

index<int>控件序号，如果有多个，给出控件下标

wait_mili_seconds<int>字符间输入间隔（毫秒），默认值为20，最大值100

timeout<int>查找控件的超时时间

调用样例 -rpa4.ai.cv.element.input_text-

# 注意事项：
# 1. 使用此方法前需要先通过捕捉控件功能捕捉对应cv类型控件
# 2. 执行时，需要确保控件所在的页面是打开状态
# 代码调用样例如下：
import rpa4.ai.cv as cv

cv.element.input_text('搜索框', 'Helen')

pos(element, *, index=1, timeout=10)

方法描述

获取CV控件坐标

参数说明

element<str>控件名

index<int>控件序号，如果有多个，给出控件下标

timeout<int>查找控件的超时时间

返回说明

• 返回坐标字典，key包含控件bounding坐标x1，x2，x3，x4及锚点坐标anchor_x，anchor_y <dict>

• 示例：{'x1':100, 'x2':100, 'y1':500, 'y2':500, 'anchor_x':300, 'anchor_y':300}

调用样例 -rpa4.ai.cv.element.input_text-

# 注意事项：
# 1. 使用此方法前需要先通过捕捉控件功能捕捉对应cv类型控件
# 2. 执行时，需要确保控件所在的页面是打开状态
# 代码调用样例如下：
import rpa4.ai.cv as cv

pos = cv.element.pos('关闭窗口')
center_x = (pos['x1'] + pos['x2']) // 2
center_y = (pos['y1'] + pos['y2']) // 2
rpa.ui.win32.click(x=center_x, y=center_y)

mouse_move(element, *, index=1, timeout=10)

方法描述

鼠标移入CV控件锚点位置

参数说明

element<str>控件名

index<int>控件序号，如果有多个，给出控件下标

timeout<int>查找控件的超时时间

调用样例 -rpa4.ai.cv.element.mouse_move-

# 注意事项：
# 1. 使用此方法前需要先通过捕捉控件功能捕捉对应cv类型控件
# 2. 执行时，需要确保控件所在的页面是打开状态
# 代码调用样例如下：
import rpa4.ai.cv as cv

cv.element.mouse_move('头像')
rpa.ui.win32.click()

wait_loaded(element, *, index=1, timeout=10)

方法描述

等待CV控件加载，成功正常结束，失败抛出异常

参数说明

element<str>控件名

index<int>控件序号，如果有多个，给出控件下标

timeout<int>查找控件的超时时间

调用样例 -rpa4.ai.cv.element.wait_loaded-

# 注意事项：
# 1. 使用此方法前需要先通过捕捉控件功能捕捉对应cv类型控件
# 2. 执行时，需要确保控件所在的页面是打开状态
# 代码调用样例如下：
import rpa4.ai.cv as cv
try:
    cv.element.wait_loaded('页面标题')
except Exception as e:
    print(e)

count(element)

方法描述

查找CV控件个数

参数说明

element<str>控件名

返回说明

返回查找到的CV控件个数<int>

调用样例 -rpa4.ai.cv.element.count-

# 注意事项：
# 1. 使用此方法前需要先通过捕捉控件功能捕捉对应cv类型控件
# 2. 执行时，需要确保控件所在的页面是打开状态
# 代码调用样例如下：
import rpa4.ai.cv as cv

num = cv.element.count('多选框')
print(num)