查找OCR文本位置
命令原型
objPoint = OCR.Find(#objElement, #objRect, #sEngine, #sAcessKey, #sSecretKey, #sText, #sRule, #iOccurrence, #iTimeOut, #optionArgs)
命令说明
使用OCR查找文本位置,成功返回字典类型的文本位置,失败引发异常,调用时需要访问互联网
适应版本
社区版与企业版
必选参数
- objElement -- 目标
- 参数描述:对应需要操作的界面元素,当属性传递为 字符串 类型时,作为特征串查找界面元素,当属性传递为 UiElement 类型时,直接对 UiElement 对应的界面元素进行点击操作
- 参数默认值:@ui""
- 适应版本:社区版与企业版
- objRect -- 识别范围
- 参数描述:需要进行OCR文字识别的范围,程序会在控件这个范围内进行文字识别,如果范围传递为 {"x":0,"y":0,"width":0,"height":0},则进行控件矩形区域范围内的文字识别
- 参数默认值:{"x":0,"y":0,"width":0,"height":0}
- 适应版本:社区版与企业版
- sEngine -- OCR引擎
- 参数描述:使用的OCR引擎
- 参数默认值:"baidu2"
- 适应版本:社区版与企业版
- sAcessKey -- Access-Key
- 参数描述:OCR服务的ApiKey
- 参数默认值:""
- 适应版本:社区版与企业版
- sSecretKey -- Secret-Key
- 参数描述:OCR服务的SecretKey
- 参数默认值:""
- 适应版本:社区版与企业版
- sText -- 查找文本
- 参数描述:查找元素时使用的文本
- 参数默认值:""
- 适应版本:社区版与企业版
- sRule -- 查找规则
- 参数描述:查找文本时使用的规则
- 参数默认值:"instr"
- 适应版本:社区版与企业版
- iOccurrence -- 相似结果位置
- 参数描述:如果“文本”字段中的字符串在指示的界面元素中出现多次,请在此处指定要单击的出现次数。例如,如果字符串出现4次并且您要单击第一个匹配项,请在此字段中写入1
- 参数默认值:1
- 适应版本:社区版与企业版
- iTimeOut -- 超时时间-毫秒
- 参数描述:指定在SelectorNotFoundException引发异常之前等待活动运行的时间量(以毫秒为单位)。默认值为10000毫秒(10秒)
- 参数默认值:10000
- 适应版本:社区版与企业版
可选参数
- bContinueOnError -- 错误继续执行
- 参数描述:指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
- 参数默认值:False
- 适应版本:社区版与企业版
- iDelayAfter -- 执行后延时
- 参数描述:执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
- 参数默认值:300
- 适应版本:社区版与企业版
- iDelayBefore -- 执行前延时
- 参数描述:活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒
- 参数默认值:200
- 适应版本:社区版与企业版
- bSetForeground -- 激活窗口
- 参数描述:进行操作之前,是否先将目标窗口激活
- 参数默认值:True
- 适应版本:社区版与企业版
返回结果
objPoint,将命令运行后的结果赋值给此变量。