rpa_mouse_drag
拖拽元素,通过模拟人的操作实现
注意:该函数运行时,鼠标操作可能影响结果,若机器人中使用了该API,机器人执行时避免人为操作鼠标
1. 函数
rpa_mouse_drag(appId, elementId, dst=(0, 0), index=0, waitElement=True, offset=(0, 0), pressed='')
- appId:字符串类型,程序Id
- elementId:字符串类型,通过捕获元素功能保存的元素Id
- dst:拖拽目标点坐标,全局坐标
- index:整数类型,元素序号,若捕获到的元素存在多个时,标识操作的元素序号,索引从0开始
- waitElement:bool类型,是否等待元素出现。若值为True,函数先等待元素出现,再执行操作;若值为False,函数直接执行操作。默认等待10秒
- offset:相对于元素中心点偏移,若该值为(0,0),则拖拽起点为elementId指定元素的中心点
- pressed:字符串类型,鼠标点击时是否按键,包括control、shift、alt,支持组合,如'control shift'
2. 返回值
若执行成功返回True,执行失败返回False,通过rpa_getLastErrorCode()获取错误码,rpa_getLastErrorMsg()获取错误信息。
3. 示例
- 将京麦桌面图标,往右拖拽200像素
appId = rpa_uia_connectDesktop()
# 计算拖拽目标位置
rect = rpa_uia_getElementRect(appId, "京麦Icon", index=0, waitElement=True)
center = rect.mid_point()
center.x = center.x + 200
# 拖拽
rpa_mouse_drag(appId, "京麦Icon", dst=(center.x, center.y), index=0, waitElement=True, offset=(0, 0), pressed='')