rpa_mouse_click
单击元素,通过模拟人的操作实现
注意:该函数运行时,鼠标操作可能影响结果,若机器人中使用了该API,机器人执行时避免人为操作鼠标
1. 函数
rpa_mouse_click(appId, elementId, left=True, index=0, waitElement=True)
- appId:字符串类型,程序Id
- elementId:字符串类型,通过捕获元素功能保存的元素Id
- left:bool类型,True-左键 False-右键
- index:整数类型,元素序号,若捕获到的元素存在多个时,标识操作的元素序号,索引从0开始
- waitElement:bool类型,是否等待元素出现。若值为True,函数先等待元素出现,再执行操作;若值为False,函数直接执行操作。默认等待10秒;
2. 返回值
若执行成功返回True,执行失败返回False,通过rpa_getLastErrorCode()获取错误码,rpa_getLastErrorMsg()获取错误信息。
3. 示例
- 通过在京麦顶部输入框中输入“jm://settings”打开系统设置
# 变量定义
jmPath = rpa_view_readParam('京麦目录')
jmPath = jmPath + '/JMWorkStation.exe'
print(jmPath)
# 连接京麦
appId = rpa_uia_connectApp(ppath=jmPath)
if not appId:
rpa_showMsgBox('连接京麦失败,错误码:%d' % rpa_getLastErrorCode())
rpa_exit()
# 顶部输入框中打开系统设置
rpa_mouse_click(appId, '顶部输入框', left=True, index=0, waitElement=True)
# 输入jm://settings,采用rpa_sendHotKey
# for key in 'jm://settings':
# rpa_sendHotKey(key, ctrl=False, alt=False, shift=False, win=False)
# 输入jm://settings,采用rpa_sendKeys
rpa_sendKeys('jm://settings')
# 回车
rpa_sendKeys('{ENTER}')
# 等待元素,判断是否打开成功
if rpa_uia_waitElement(appId, "页面-系统设置标题", timeout=10.0, index=0):
print('打开成功')
else:
print('打开失败')