跳到主要内容

鼠标点击文本

命令说明

使用 Laiye Intelligent Document Processing 对窗口范围内进行指定文字识别,如果识别到指定文字就点击它

命令原型

Mage.Click(objUiElement,objRect,config,sText,iRule,iOccurrence,iButton,iType,iTimeOut,optionArgs)

命令参数

参数必选类型默认值说明
objUiElementTruedecorator@ui""通过鼠标选取或截取需要识别的目标屏幕范围。包含窗口、元素、范围等信息
objRectTruedictionary{"x":0,"y":0,"width":0,"height":0}需要进行OCR文字识别的范围,程序会在控件这个范围内进行文字识别,如果范围传递为 {"x":0,"y":0,"width":0,"height":0},则进行控件矩形区域范围内的文字识别
configTrueexpression{}Laiye Intelligent Document Processing 的调用配置
sTextTruestring""查找元素时使用的文本
iRuleTrueenum"instr"查找文本时使用的规则
iOccurrenceTruenumber1如果“文本”字段中的字符串在指示的界面元素中出现多次,请在此处指定要单击的出现次数。例如,如果字符串出现4次并且您要单击第一个匹配项,请在此字段中写入1
iButtonTrueenum"left"鼠标按键 {left:左键, right:右键, middle:中键}
iTypeTrueenum"click"点击类型 {click:单击, dbclick:双击, down:按下, up:弹起}
iTimeOutTruenumber30000指定等待重试查找屏幕范围时间(以毫秒为单位),如果超出该时间,则引发错误。默认30000毫秒(30秒)
bContinueOnErrorFalsebooleanFalse指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
iDelayAfterFalsenumber300执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
iDelayBeforeFalsenumber200活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒
sCursorPositionFalseenum"Center"描述添加OffsetX和OffsetY属性的偏移量的光标起点。可以使用以下选项:TopLeft,TopRight,BottomLeft,BottomRight和Center。默认选项是Center
iCursorOffsetXFalsenumber0根据在“位置”字段中选择的选项,光标位置的水平位移
iCursorOffsetYFalsenumber0根据在“位置”字段中选择的选项,光标位置的垂直位移
sKeyModifiersFalseset[]触发鼠标动作时同时按下的键盘按键,可以使用以下选项:Alt,Ctrl,Shift,Win
sSimulateFalseenum"simulate"可选择操作类型为:后台操作(uia)、模拟操作(simulate)、系统消息(message),默认选择:模拟操作(simulate)

运行实例

/**********************鼠标点击文本**********************
命令原型:
Mage.Click(@ui"",{"x":0,"y":0,"width":0,"height":0},{},"","instr",1,"left","click",30000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"sCursorPosition":"Center","iCursorOffsetX":0,"iCursorOffsetY":0,"sKeyModifiers":[],"sSimulate":"simulate"})
入参:
objUiElement--目标,该示例中使用的是chrome打开百度首页的“百度一下”按钮元素
objRect--识别范围.默认值:{"x":0,"y":0,"width":0,"height":0}
config--mage配置,需配置Pubkey和Secret.Type:Dict
sText--查找文本
iRule--查找规则
iOccurrence--相似结果位置
iButton--鼠标点击
iType--点击类型
iTimeOut--超时时间.默认单位:毫秒.Type:Int
optionArgs--可选参数(包括:错误继续执行/执行后延时/执行前延时/光标位置/横坐标偏移/纵坐标偏移/辅助按键/操作类型).Type:Dict
注意事项:
1. 需要获取mage对应的Key/Secret和URL
2. 元素需要重新录制
****************************************************/

Mage.Click(@ui"输入控件<input>_百度一下",{"x":0,"y":0,"width":0,"height":0},{"Pubkey":"sCXf4tfmGpq8um0rY2MOvApD","Secret":"KLAhZgzHVqb945HAywi5sAhbxkakSHGx","Url":"https://demo.laiye.com:8082"},"百度一下","instr",1,"left","click",30000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"sCursorPosition":"Center","iCursorOffsetX":0,"iCursorOffsetY":0,"sKeyModifiers":[],"sSimulate":"simulate"})

可视化样例