点击文本

命令原型

Text.Click(#objUiElement,#sText,#iRule,#iOccurrence,#iButton,#iType,#iTimeOut,#optionArgs)

命令说明

按照规则搜索含有指定字符串的界面元素并点击这个界面元素，点击位置为查找到的文本位置

适应版本

社区版与企业版

必选参数

objUiElement -- 目标

参数描述：需要查找文本的父元素，程序会在这个元素内查找文本操作，当属性传递为 字符串 类型时，作为特征串查找界面元素后查找子元素，当属性传递为 UiElement 类型时，直接在这个 UiElement 元素中进行查找，如果传递为 null，则在所有窗口中查找

参数默认值：@ui""

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

sText -- 查找文本

参数描述：查找元素时使用的文本

参数默认值：""

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

iRule -- 查找规则

参数描述：查找文本时使用的规则

参数默认值："instr"

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

iOccurrence -- 相似结果位置

参数描述：如果“文本”字段中的字符串在指示的界面元素中出现多次，请在此处指定要单击的出现次数。例如，如果字符串出现4次并且您要单击第一个匹配项，请在此字段中写入1

参数默认值：1

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

iButton -- 鼠标点击

参数描述：鼠标按键 {left:左键, right:右键, middle:中键}

参数默认值："left"

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

iType -- 点击类型

参数描述：点击类型 {click:单击, dbclick:双击, down:按下, up:弹起}

参数默认值："click"

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

iTimeOut -- 超时时间-毫秒

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

参数默认值：10000

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

可选参数

bContinueOnError -- 错误继续执行

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

参数默认值：False

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

iDelayAfter -- 执行后延时

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

参数默认值：300

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

iDelayBefore -- 执行前延时

参数描述：活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认的时间量是200毫秒

参数默认值：200

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

bSetForeground -- 激活窗口

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

参数默认值：True

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

sCursorPosition -- 光标位置

参数描述：描述添加OffsetX和OffsetY属性的偏移量的光标起点。可以使用以下选项：TopLeft，TopRight，BottomLeft，BottomRight和Center。默认选项是Center

参数默认值："Center"

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

iCursorOffsetX -- 横坐标偏移

参数描述：根据在“位置”字段中选择的选项，光标位置的水平位移

参数默认值：0

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

iCursorOffsetY -- 纵坐标偏移

参数描述：根据在“位置”字段中选择的选项，光标位置的垂直位移

参数默认值：0

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

sKeyModifiers -- 辅助按键

参数描述：触发鼠标动作时同时按下的键盘按键，可以使用以下选项：Alt，Ctrl，Shift，Win

参数默认值：[]

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

sSimulate -- 操作类型

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

参数默认值："simulate"

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