查找文本位置

命令说明

使用 Laiye Intelligent Document Processing 查找文本位置，成功返回字典类型的文本位置，失败引发异常

命令原型

objPoint = Mage.Find(objElement, objRect,config,sText, sRule, iOccurrence, iTimeOut, optionArgs)

命令参数

参数	必选	类型	默认值	说明
objElement	True	decorator	@ui""	通过鼠标选取或截取需要识别的目标屏幕范围。包含窗口、元素、范围等信息
objRect	True	dictionary	{"x":0,"y":0,"width":0,"height":0}	需要进行OCR文字识别的范围，程序会在控件这个范围内进行文字识别，如果范围传递为 {"x":0,"y":0,"width":0,"height":0}，则进行控件矩形区域范围内的文字识别
config	True	expression	{}	Laiye Intelligent Document Processing 的调用配置
sText	True	string	""	查找元素时使用的文本
sRule	True	enum	"instr"	查找文本时使用的规则
iOccurrence	True	number	1	如果“文本”字段中的字符串在指示的界面元素中出现多次，请在此处指定要单击的出现次数。例如，如果字符串出现4次并且您要单击第一个匹配项，请在此字段中写入1
iTimeOut	True	number	30000	指定等待重试查找屏幕范围时间（以毫秒为单位），如果超出该时间，则引发错误。默认30000毫秒（30秒）
bContinueOnError	False	boolean	False	指定即使活动引发错误，自动化是否仍应继续。该字段仅支持布尔值（True，False）。默认值为False
iDelayAfter	False	number	300	执行活动后的延迟时间（以毫秒为单位）。默认时间为300毫秒
iDelayBefore	False	number	200	活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认的时间量是200毫秒

返回结果

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

运行实例

/**********************查找文本位置**********************
命令原型:
    objPoint = Mage.Find(@ui"", {"x":0,"y":0,"width":0,"height":0},{},"", "instr", 1, 30000, {"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200})
入参:
    objElement--目标,该示例中使用的是chrome打开百度首页的“百度一下”按钮元素
    objRect--识别范围.默认值:{"x":0,"y":0,"width":0,"height":0}
    config--mage配置,需配置Pubkey和Secret.Type:Dict
    sText--查找文本
    sRule--查找规则
    iOccurrence--相似结果位置
    iTimeOut--超时时间.默认单位:毫秒.Type:Int
    optionArgs--可选参数(包括:错误继续执行/执行后延时/执行前延时/光标位置/横坐标偏移/纵坐标偏移/辅助按键/操作类型).Type:Dict
出参:
    objPoint--函数调用的输出保存到的变量
注意事项：
    需要获取mage对应的Key/Secret和URL
****************************************************/
Dim objPoint=""  // 输出结果

objPoint = Mage.Find(@ui"输入控件<input>_百度一下", {"x":0,"y":0,"width":0,"height":0},{"Pubkey":"sCXf4tfmGpq8um0rY9MOvApD","Secret":"KLAhZgzHVqb975HAywi5sAhbxkakSHGx","Url":"https://demo.laiye.com:8082"},"百度一下", "instr", 1, 30000, {"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200})
TracePrint objPoint

可视化样例