跳到主要内容

鼠标移动到图像上

命令说明

在指定范围内搜索图像并将鼠标指针移动到图像之上

命令原型

Image.Hover(objUiElement,objRect,sImagePath,iAccuracy,iTimeOut,optionArgs)

命令参数

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

运行实例

/************************鼠标移动到图像上************************
命令原型:
Image.Hover(objUiElement,objRect,sImagePath,iAccuracy,iTimeOut,optionArgs)
入参:
objUiElement--目标元素
objRect--识别范围
sImagePath--查找图片
iAccuracy--相似度
iTimeOut--超时时间.默认单位:毫秒.Type:Int
optionArgs--可选参数(包括:错误继续执行/执行后延时/执行前延时/激活窗口/光标位置/横坐标偏移/纵坐标偏移/辅助按键/操作类型/匹配方式/匹配序号).Type:Dict
出参:

注意事项:
必须选定目标
***********************************************************/
Image.Hover({"wnd":[{"cls":"Chrome_WidgetWin_1","title":"百度一下,你就知道 - Google Chrome","app":"chrome"}]},{"x": 0, "y": 0, "width": 0, "height": 0},@res"895d6a20-d4c1-11ec-adbf-19b54b1b1b3f.png",0.9,10000,{"bContinueOnError": false, "iDelayAfter": 300, "iDelayBefore": 200, "bSetForeground": true, "sCursorPosition": "Center", "iCursorOffsetX": 10, "iCursorOffsetY": 10, "sKeyModifiers": [],"sSimulate": "simulate","sMatchType":"GrayMatch", "iSerialNo": 1})

可视化样例