鼠标移动到图像上
命令原型
Image.Hover(#objUiElement,#objRect,#sImagePath,#iAccuracy,#iTimeOut,#optionArgs)
命令说明
在指定范围内搜索图像并将鼠标指针移动到图像之上
适应版本
社区版与企业版
必选参数
- objUiElement -- 目标
- 参数描述:对应需要操作的界面元素,当属性传递为 字符串 类型时,作为特征串查找界面元素,当属性传递为 UiElement 类型时,直接对 UiElement 对应的界面元素进行点击操作
- 参数默认值:{}
- 适应版本:社区版与企业版
- objRect -- 识别范围
- 参数描述:需要查找的范围,程序会在控件这个范围内进行文字识别,如果范围传递为 {"x":0,"y":0,"width":0,"height":0},则进行控件矩形区域范围内的文字识别
- 参数默认值:{"x": 0, "y": 0, "width": 0, "height": 0}
- 适应版本:社区版与企业版
- sImagePath -- 查找图片
- 参数描述:要查找的图片路径,一般在res文件夹
- 参数默认值:'''C:\Users'''
- 适应版本:社区版与企业版
- iAccuracy -- 相似度
- 参数描述:查找图片时使用的相似度,相似度范围从 0.5 - 1.0,表示 50% - 100% 相似
- 参数默认值:0.9
- 适应版本:社区版与企业版
- iTimeOut -- 超时时间-毫秒
- 参数描述:指定在SelectorNotFoundException引发异常之前等待活动运行的时间量(以毫秒为单位)。默认值为10000毫秒(10秒)
- 参数默认值:10000
- 适应版本:社区版与企业版
可选参数
- bContinueOnError -- 错误继续执行
- 参数描述:指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
- 参数默认值:False
- 适应版本:社区版与企业版
- iDelayAfter -- 执行后延时
- 参数描述:执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
- 参数默认值:300
- 适应版本:社区版与企业版
- iDelayBefore -- 执行前延时
- 参数描述:活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒
- 参数默认值:200
- 适应版本:社区版与企业版
- bSetForeground -- 激活窗口
- 参数描述:进行操作之前,是否先将目标窗口激活
- 参数默认值:True
- 适应版本:社区版与企业版
- sCursorPosition -- 光标位置
- 参数描述:描述添加OffsetX和OffsetY属性的偏移量的光标起点。可以使用以下选项:TopLeft,TopRight,BottomLeft,BottomRight和Center。默认选项是Center
- 参数默认值:"Center"
- 适应版本:社区版与企业版
- iCursorOffsetX -- 横坐标偏移
- 参数描述:根据在“位置”字段中选择的选项,光标位置的水平位移
- 参数默认值:0
- 适应版本:社区版与企业版
- iCursorOffsetY -- 纵坐标偏移
- 参数描述:根据在“位置”字段中选择的选项,光标位置的垂直位移
- 参数默认值:0
- 适应版本:社区版与企业版
- sKeyModifiers -- 辅助按键
- 参数描述:触发鼠标动作时同时按下的键盘按键,可以使用以下选项:Alt,Ctrl,Shift,Win
- 参数默认值:[]
- 适应版本:社区版与企业版
- sSimulate -- 操作类型
- 参数描述:可选择操作类型为:后台操作(uia)、模拟操作(simulate)、系统消息(message),默认选择:模拟操作(simulate)
- 参数默认值:"simulate"
- 适应版本:社区版与企业版
- sMatchType -- 匹配方式
- 参数描述:指定查找图像的匹配方式,“灰度匹配”速度快,但在极端情况下可能会匹配失败,“彩色匹配”相对“灰度匹配”更精准但匹配速度稍慢
- 参数默认值:"GrayMatch"
- 适应版本:社区版与企业版
- iSerialNo -- 匹配序号
- 参数描述:指定图像匹配到多个目标时的序号,序号为从1开始的正整数,在屏幕上从左到右从上到下依次递增,匹配到最靠近屏幕左上角的目标序号为1
- 参数默认值:1
- 适应版本:社区版与企业版