跳到主要内容

智能识别后输入文本

命令说明

智能识别后输入文本

命令原型

UiDetection.InputText(objUiElement,sText,bEmptyField,iInterval,iTimeout,optionArgs)

命令参数

参数必选类型默认值说明
objUiElementTrueexpression{}选取的智能识别后的目标元素及锚点元素的特征值
sTextTruestring""指定的目标元素中写入文本
bEmptyFieldTruebooleanTrue写入文本之前是否清空输入框
iIntervalTruenumber200两次输入的间隔时间,间隔时间过小可能导致丢字,建议默认200毫秒
iTimeoutTruenumber30000指定在SelectorNotFoundException引发异常之前等待活动运行的时间量(以毫秒为单位)。默认值为30000毫秒(30秒)
bContinueOnErrorFalsebooleanFalse指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
iDelayAfterFalsenumber300执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
iDelayBeforeFalsenumber200活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒
sKeyModifiersFalseset[]触发鼠标动作时同时按下的键盘按键,可以使用以下选项:Alt,Ctrl,Shift,Win
bSetForegroundFalsebooleanTrue进行操作之前,是否先将目标窗口激活
sSimulateFalseenum"message"可选择操作类型为:模拟操作(simulate)、系统消息(message),默认选择:系统消息(message)

运行实例

/*********************************智能识别后输入文本***************************************
命令原型:
UiDetection.InputText({},"",true,200,30000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"sKeyModifiers":[],"bSetForeground":true,"sSimulate":"message"})
入参:
objUiElement--识别目标。注:选取的智能识别后的目标元素及锚点元素的特征值
sText--写入文本。注:指定的目标元素中写入文本
bEmptyField--清空原内容。注:写入文本之前是否清空输入框
iInterval--键入间隔(毫秒)。注:两次输入的间隔时间,间隔时间过小可能导致丢字,建议默认200毫秒
iTimeOut--超时时间(毫秒)。注:查找目标引发异常之前等待命令重试运行的时间量,以毫秒为单位。默认30000(30秒)
optionArgs--可选参数(包括:错误继续执行、执行后延时、执行前延时、激活窗口、光标位置、横坐标偏移、纵坐标偏移、辅助按键、操作类型).Type:Dict
注意事项:
1.该命令只进行文本输入,需要结合智能识别屏幕范围命令一同使用。
2.执行命令前需要目标屏幕存在,否则会报错。
********************************************************************************/
#icon("@res:95f63900-7f22-11ec-ab08-1d7b5faf0fee.png")
UiDetection.InputText({"wnd":[{"cls":"Chrome_WidgetWin_1","title":"Click - 飞书云文档 - Google Chrome","app":"chrome"}],"cv_engine_version":1,"cv_region":{"x":0,"y":0,"width":0,"height":0},"cv_descriptor":{"confidence":0.800000011920929,"cv_handle":"\"2b3223b0-7f20-11ec-ab08-1d7b5faf0fee\"","match_version":1,"target":{"cls_type":100,"height":17,"text":"UiDetection.C1ick(objUiElement,iButton,iType,iTimeout,optionArgs","width":529,"x":643,"y":544}}},"测试",true,200,30000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"sKeyModifiers":[],"bSetForeground":true,"sSimulate":"message"})

可视化样例