跳到主要内容

获取子元素

命令说明

一个指定的目标元素可能由多个子元素聚合而成,而子元素自身可能又是被更内层的多个子元素聚合而成,依次类推而形成一个树结构,通过指定子元素层级,可获取至层级(含)范围内的所有元素,并以一维数组的形式返回,且数组内的元素为内存地址对象

命令原型

arrElement = UiElement.GetChildren(objUiElement,level, optionArgs)

命令参数

参数必选类型默认值说明
objUiElementTruedecorator@ui""指定被获取子元素的根节点元素
levelTruenumber1默认子元素层级为1,即根节点元素下的第1级所有元素(子元素)。当子元素层级为2时,则代表返回包含第1级(子元素)和第2级(孙元素)的所有元素;当子元素层级为3时,则代表返回包含第1级(子元素)、第2级(孙元素)及第3级(曾孙元素)的所有元素;当子元素层级为4时,依次类推;当子元素层级超出实际层级范围时,则与至最末层级(即为0)的返回结果一样,即返回其包含所有层级的元素
bContinueOnErrorFalsebooleanFalse指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
iDelayAfterFalsenumber300执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
iDelayBeforeFalsenumber200活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒

返回结果

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

运行实例

/*******************************获取子元素******************************
命令原型:
arrElement = UiElement.GetChildren(objUiElement,level, optionArgs)
入参:
objUiElement--目标元素
level--子元素层级
optionArgs--可选参数(包括:错误继续执行/执行后延时/执行前延时).Type:Dict
出参:
arrElement--函数调用的输出保存到的变量
注意事项:

*********************************************************************/
arrElement = UiElement.GetChildren(@ui"块级元素<div>_百度首页设置登录新闻hao123地图贴吧视频图片网盘更多翻译学术文库百科知道健康",1, {"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200})
TracePrint(arrElement)

可视化样例