在目标中输入

命令原型

Keyboard.InputText(#objUiElement,#sText,#bEmptyField,#iDelayBetweenKeys,#iTimeOut,#optionArgs)

命令说明

在指定的界面元素中输入文本

适应版本

社区版与企业版

必选参数

objUiElement -- 目标

参数描述：对应需要操作的界面元素，当属性传递为 字符串 类型时，作为特征串查找界面元素，当属性传递为 UiElement 类型时，直接对 UiElement 对应的界面元素进行点击操作

参数默认值：@ui""

适应版本：社区版与企业版

sText -- 写入文本

参数描述：要在指定的界面元素中写入的文本

参数默认值：""

适应版本：社区版与企业版

bEmptyField -- 清空原内容

参数描述：写入文本之前是否清空输入框

参数默认值：True

适应版本：社区版与企业版

iDelayBetweenKeys -- 键入间隔-毫秒

参数描述：两次输入之间的间隔，（仅在“操作类型”属性中选项为”模拟操作“时生效）低于20毫秒时会自动转为20毫秒，间隔的值过小有可能导致输入时丢字，与机器的性能有关

参数默认值：20

适应版本：社区版与企业版

iTimeOut -- 超时时间-毫秒

参数描述：指定在SelectorNotFoundException引发异常之前等待活动运行的时间量（以毫秒为单位）。默认值为10000毫秒（10秒）

参数默认值：10000

适应版本：社区版与企业版

可选参数

bContinueOnError -- 错误继续执行

参数描述：指定即使活动引发错误，自动化是否仍应继续。该字段仅支持布尔值（True，False）。默认值为False

参数默认值：False

适应版本：社区版与企业版

iDelayAfter -- 执行后延时

参数描述：执行活动后的延迟时间（以毫秒为单位）。默认时间为300毫秒

参数默认值：300

适应版本：社区版与企业版

iDelayBefore -- 执行前延时

参数描述：活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认的时间量是500毫秒，过短可能导致漏输入情况

参数默认值：500

适应版本：社区版与企业版

bSetForeground -- 激活窗口

参数描述：进行操作之前，是否先将目标窗口激活

参数默认值：True

适应版本：社区版与企业版

sSimulate -- 操作类型

参数描述：可选择操作类型为：后台操作(uia)、模拟操作(simulate)、系统消息(message)，默认选择：系统消息(message)

参数默认值："message"

适应版本：社区版与企业版

bValidate -- 验证写入文本

参数描述：将 “写入文本”属性内容与实际输入内容进行比较，内容相同继续运行，内容不同抛出异常

参数默认值：False

适应版本：社区版与企业版

bClickBeforeInput -- 输入前点击

参数描述：找到目标后先点击目标再输入内容

参数默认值：False

适应版本：社区版与企业版