查找图像

命令说明

在指定范围内查找图像

命令原型

objPoint = Image.Find(objUiElement,objRect,sImagePath,iAccuracy,iTimeOut,optionArgs)

命令参数

参数	必选	类型	默认值	说明
objUiElement	True	decorator	@ui""	对应需要操作的界面元素，当属性传递为 字符串 类型时，作为特征串查找界面元素，当属性传递为 UiElement 类型时，直接对 UiElement 对应的界面元素进行点击操作
objRect	True	dictionary	{"x": 0, "y": 0, "width": 0, "height": 0}	需要查找的范围，程序会在控件这个范围内进行文字识别，如果范围传递为 {"x":0,"y":0,"width":0,"height":0}，则进行控件矩形区域范围内的文字识别
sImagePath	True	path	'''C:\Users'''	要查找的图片路径，一般在res文件夹
iAccuracy	True	number	0.9	查找图片时使用的相似度，相似度范围从 0.5 - 1.0，表示 50% - 100% 相似
iTimeOut	True	number	10000	指定在SelectorNotFoundException引发异常之前等待活动运行的时间量（以毫秒为单位）。默认值为10000毫秒（10秒）
bContinueOnError	False	boolean	False	指定即使活动引发错误，自动化是否仍应继续。该字段仅支持布尔值（True，False）。默认值为False
iDelayAfter	False	number	300	执行活动后的延迟时间（以毫秒为单位）。默认时间为300毫秒
iDelayBefore	False	number	200	活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认的时间量是200毫秒
bSetForeground	False	boolean	True	进行操作之前，是否先将目标窗口激活
sMatchType	False	enum	"GrayMatch"	指定查找图像的匹配方式，“灰度匹配”速度快，但在极端情况下可能会匹配失败，“彩色匹配”相对“灰度匹配”更精准但匹配速度稍慢
iSerialNo	False	number	1	指定图像匹配到多个目标时的序号，序号为从1开始的正整数，在屏幕上从左到右从上到下依次递增，匹配到最靠近屏幕左上角的目标序号为1

返回结果

objPoint，将命令运行后的结果赋值给此变量。

运行实例

/************************查找图像************************
命令原型:
    objPoint = Image.Find(objUiElement,objRect,sImagePath,iAccuracy,iTimeOut,optionArgs)
入参:
    objUiElement--目标元素
    objRect--识别范围
    sImagePath--查找图片
    iAccuracy--相似度
    iTimeOut--超时时间.默认单位:毫秒.Type:Int
    optionArgs--可选参数(包括:错误继续执行/执行后延时/执行前延时/激活窗口/匹配方式/匹配序号).Type:Dict
出参:
    objPoint--函数调用的输出保存到的变量
注意事项:
    必须选定目标        
***********************************************************/
objPoint = Image.Find({"wnd":[{"cls":"Chrome_WidgetWin_1","title":"百度一下，你就知道 - Google Chrome","app":"chrome"}]},{"x": 0, "y": 0, "width": 0, "height": 0},@res"819da920-d4c2-11ec-adbf-19b54b1b1b3f.png",0.9,10000,{"bContinueOnError": false, "iDelayAfter": 300, "iDelayBefore": 200, "bSetForeground": true, "sMatchType":"ColorMatch", "iSerialNo": 1})

可视化样例