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

命令说明

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

命令原型

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

命令参数

参数	必选	类型	默认值	说明
objUiElement	True	decorator	@ui""	通过鼠标选取的界面元素，包含窗口、元素等信息
sText	True	string	""	查找时使用的文本
iRule	True	enum	"instr"	查找时使用的规则
iTimeOut	True	number	30000	指定等待重试查找文本时间（以毫秒为单位），如果超出该时间，则引发错误。默认30000毫秒（30秒）
bContinueOnError	False	boolean	False	指定即使活动引发错误，自动化是否仍应继续。该字段仅支持布尔值（True，False）。默认值为False
iDelayAfter	False	number	300	执行活动后的延迟时间（以毫秒为单位）。默认时间为300毫秒
iDelayBefore	False	number	200	活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认的时间量是200毫秒
bSetForeground	False	boolean	True	当目标窗口为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)

可视化样例