跳到主要内容

查找文本所在位置的界面元素

命令说明

按照查找文本规则,查找出文本所在位置的界面元素

命令原型

arrElement = Text.FindElement(objUiElement,sText,iRule,iTimeOut,optionArgs)

命令参数

参数必选类型默认值说明
objUiElementTruedecorator@ui""通过鼠标选取的界面元素,包含窗口、元素等信息
sTextTruestring""查找时使用的文本
iRuleTrueenum"instr"查找时使用的规则
iTimeOutTruenumber30000指定等待重试查找文本时间(以毫秒为单位),如果超出该时间,则引发错误。默认30000毫秒(30秒)
bContinueOnErrorFalsebooleanFalse指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
iDelayAfterFalsenumber300执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
iDelayBeforeFalsenumber200活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒
bSetForegroundFalsebooleanTrue当目标窗口为IE浏览器时,可设置操作前是否激活该窗口,默认为是

返回结果

arrElement,将命令运行后的结果赋值给此变量。

运行实例

/*********************************查找文本所在位置的界面元素***************************************
命令原型:
arrElement = Text.FindElement(@ui"","","instr",30000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true})
入参:
objUiElement--识别目标。
sText--需要在目标中查找的文本。注:查找元素时使用的文本
iRule--查找规则。注:查找文本时使用的规则
iTimeOut--超时时间(毫秒)。注:指定等待重试查找屏幕范围时间(以毫秒为单位),如果超出该时间,则引发错误。默认30000毫秒(30秒)
optionArgs--可选参数(包括:错误继续执行、执行后延时、执行前延时、激活窗口).Type:Dict
出参:
arrElement--函数调用的输出保存到的变量
注意事项:
1.在使用时要注意查找规则的选择,区分字符串和正则表达式
********************************************************************************/
Dim arrElement = ""
arrElement = Text.FindElement(@ui"文本<span>_查找文本所在位置的界面元素","查找","instr",30000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true})
TracePrint(arrElement)

可视化样例