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