判断文本是否存在
命令说明
在指定元素中查找文本,文本存在返回 true,否则返回 false
命令原型
bRet = Text.Exists(objUiElement,sText,iRule,iOccurrence,iTimeOut,optionArgs)
命令参数
参数 | 必选 | 类型 | 默认值 | 说明 |
---|---|---|---|---|
objUiElement | True | decorator | @ui"" | 需要查找文本的父元素,程序会在这个元素内查找文本操作,当属性传递为 字符串 类型时,作为特征串查找界面元素后查找子元素,当属性传递为 UiElement 类型时,直接在这个 UiElement 元素中进行查找,如果传递为 null,则在所有窗口中查找 |
sText | True | string | "" | 查找元素时使用的文本 |
iRule | True | enum | "instr" | 查找文本时使用的规则 |
iOccurrence | True | number | 1 | 如果“文本”字段中的字符串在指示的界面元素中出现多次,请在此处指定要单击的出现次数。例如,如果字符串出现4次并且您要单击第一个匹配项,请在此字段中写入1 |
iTimeOut | True | number | 10000 | 指定在SelectorNotFoundException引发异常之前等待活动运行的时间量(以毫秒为单位)。默认值为10000毫秒(10秒) |
bContinueOnError | False | boolean | False | 指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False |
iDelayAfter | False | number | 300 | 执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒 |
iDelayBefore | False | number | 200 | 活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒 |
bSetForeground | False | boolean | True | 进行操作之前,是否先将目标窗口激活 |
返回结果
bRet,将命令运行后的结果赋值给此变量。
运行实例
/*********************************判断文本是否存在***************************************
命令原型:
bRet = Text.Exists(@ui"","","instr",1,10000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true})
入参:
objUiElement--识别目标。
sText--需要在目标中查找的文本。注:查找元素时使用的文本
iRule--查找规则。注:查找文本时使用的规则
iOccurrence--相似结果位置。
iTimeOut--超时时间(毫秒)。注:指定等待重试查找屏幕范围时间(以毫秒为单位),如果超出该时间,则引发错误。默认30000毫秒(30秒)
optionArgs--可选参数(包括:错误继续执行、执行后延时、执行前延时、激活窗口、光标位置、横坐标偏移、纵坐标偏移、辅助按键、操作类型).Type:Dict
出参:
bRet--函数调用的输出保存到的变量
注意事项:
1.在使用时要保证目标元素已经加载完成,否则很容易造成判断为false的情况。
********************************************************************************/
Dim bRet = ""
bRet = Text.Exists(@ui"块级元素<div>_Exists判断文本是否存在命令说明在指定元素中查找文本,文本存在返回true,","文本","instr",1,10000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true})
TracePrint(bRet)