跳到主要内容

判断文本是否存在

命令说明

在指定元素中查找文本,文本存在返回 true,否则返回 false

命令原型

bRet = Text.Exists(objUiElement,sText,iRule,iOccurrence,iTimeOut,optionArgs)

命令参数

参数必选类型默认值说明
objUiElementTruedecorator@ui""需要查找文本的父元素,程序会在这个元素内查找文本操作,当属性传递为 字符串 类型时,作为特征串查找界面元素后查找子元素,当属性传递为 UiElement 类型时,直接在这个 UiElement 元素中进行查找,如果传递为 null,则在所有窗口中查找
sTextTruestring""查找元素时使用的文本
iRuleTrueenum"instr"查找文本时使用的规则
iOccurrenceTruenumber1如果“文本”字段中的字符串在指示的界面元素中出现多次,请在此处指定要单击的出现次数。例如,如果字符串出现4次并且您要单击第一个匹配项,请在此字段中写入1
iTimeOutTruenumber10000指定在SelectorNotFoundException引发异常之前等待活动运行的时间量(以毫秒为单位)。默认值为10000毫秒(10秒)
bContinueOnErrorFalsebooleanFalse指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
iDelayAfterFalsenumber300执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
iDelayBeforeFalsenumber200活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒
bSetForegroundFalsebooleanTrue进行操作之前,是否先将目标窗口激活

返回结果

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)

可视化样例