Skip to main content

鼠标移动到OCR文本上

命令说明

使用OCR对界面元素范围内进行指定文字识别,如果识别到指定文字将光标移动到文本所在的位置,调用时需要访问互联网

命令原型

OCR.Hover(objUiElement,objRect,sEngine,sAcessKey,sSecretKey,sText,sRule,iOccurrence,iTimeOut,optionArgs)

命令参数

参数必选类型默认值说明
objUiElementTruedecorator@ui""对应需要操作的界面元素,当属性传递为 字符串 类型时,作为特征串查找界面元素,当属性传递为 UiElement 类型时,直接对 UiElement 对应的界面元素进行点击操作
objRectTruedictionary{"x":0,"y":0,"width":0,"height":0}需要进行OCR文字识别的范围,程序会在控件这个范围内进行文字识别,如果范围传递为 {"x":0,"y":0,"width":0,"height":0},则进行控件矩形区域范围内的文字识别
sEngineTrueenum"baidu2"使用的OCR引擎
sAcessKeyTruestring""OCR服务的ApiKey
sSecretKeyTruestring""OCR服务的SecretKey
sTextTruestring""查找元素时使用的文本
sRuleTrueenum"instr"查找文本时使用的规则
iOccurrenceTruenumber1如果“文本”字段中的字符串在指示的界面元素中出现多次,请在此处指定要单击的出现次数。例如,如果字符串出现4次并且您要单击第一个匹配项,请在此字段中写入1
iTimeOutTruenumber10000指定在SelectorNotFoundException引发异常之前等待活动运行的时间量(以毫秒为单位)。默认值为10000毫秒(10秒)
bContinueOnErrorFalsebooleanFalse指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
iDelayAfterFalsenumber300执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
iDelayBeforeFalsenumber200活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒
bSetForegroundFalsebooleanTrue进行操作之前,是否先将目标窗口激活
sCursorPositionFalseenum"Center"描述添加OffsetX和OffsetY属性的偏移量的光标起点。可以使用以下选项:TopLeft,TopRight,BottomLeft,BottomRight和Center。默认选项是Center
iCursorOffsetXFalsenumber0根据在“位置”字段中选择的选项,光标位置的水平位移
iCursorOffsetYFalsenumber0根据在“位置”字段中选择的选项,光标位置的垂直位移
sKeyModifiersFalseset[]触发鼠标动作时同时按下的键盘按键,可以使用以下选项:Alt,Ctrl,Shift,Win
sSimulateFalseenum"simulate"可选择操作类型为:后台操作(uia)、模拟操作(simulate)、系统消息(message),默认选择:模拟操作(simulate)

运行实例

/*********************************鼠标移动到OCR文本上***************************************
命令原型:
OCR.Hover(@ui"",{"x":0,"y":0,"width":0,"height":0},"baidu2","","","","instr",1,10000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true,"sCursorPosition":"Center","iCursorOffsetX":0,"iCursorOffsetY":0,"sKeyModifiers":[],"sSimulate":"simulate"})
入参:
objUiElement--识别目标。
objRect--目标识别范围。默认值:{"x":0,"y":0,"width":0,"height":0}
sEngine--OCR引擎。注:使用的OCR引擎
sAcessKey--百度OCR引擎ApiKey。注:OCR服务的ApiKey(需要注册OCR账号,创建应用获取该参数)
sSecretKey--百度OCR引擎SecretKey。注:OCR服务的SecretKey(需要注册OCR账号,创建应用获取该参数)
sText--查找文本。注:查找元素时使用的文本
sRule--查找规则。注:查找文本时使用的规则
iOccurrence--相似结果位置。
iTimeOut--超时时间。注:指定在SelectorNotFoundException引发异常之前等待活动运行的时间量(以毫秒为单位)。默认值为10000毫秒(10秒)
optionArgs--可选参数(包括:错误继续执行、执行后延时、执行前延时、激活窗口、光标位置、横坐标偏移、纵坐标偏移、辅助按键、操作类型).Type:Dict
注意事项:
1.该命令是调用外部百度OCR接口,需要提前创建好百度OCR账号以及对应应用,获取应用对应密钥(Access Key和Secret Key)。
2.要保证OCR操作的窗口存在,否则命令执行会报错。
3.运行该命令时需要能够连接外网。
********************************************************************************/
OCR.Hover(@ui"文本<span>_鼠标移动到OCR文本上",{"x":0,"y":0,"width":0,"height":0},"baidu2","P10qsjDcuoN5ZU7dnSHmXzGh","Fm8whYrNnXtKkSvqVPUYL573XfNbxlmO","文本","instr",1,10000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true,"sCursorPosition":"Center","iCursorOffsetX":0,"iCursorOffsetY":0,"sKeyModifiers":[],"sSimulate":"simulate"})

可视化样例