跳到主要内容

获取父元素

命令说明

通常一个指定的目标元素有且为唯一的父元素,而父元素又有自己的父元素,直至最顶层的父元素(即桌面),从而可获取指定父元素层级的且为唯一的父元素,返回结果为内存地址对象

命令原型

objElement = UiElement.GetParent(objUiElement,upLevels,optionArgs)

命令参数

参数必选类型默认值说明
objUiElementTruedecorator@ui""指定被获取父元素的目标元素
upLevelsTruenumber1默认父元素层级为1,即为直接父级元素。当父元素层级为2时,则获取指定目标元素的父级元素的父级元素(祖父元素);当父元素层级为3时,则获取指定目标元素的父级元素的父级元素的父级元素(曾祖父元素);当父元素层级为4时,依次类推;当父元素层级超出最顶层元素(桌面)或者父元素层级 <=0 时,则获取的父元素为桌面
bContinueOnErrorFalsebooleanFalse指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
iDelayAfterFalsenumber300执行活动后的延迟时间(以毫秒为单位)。默认时间为300毫秒
iDelayBeforeFalsenumber200活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是200毫秒

返回结果

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

运行实例

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

*********************************************************************/
objElement = UiElement.GetParent(@ui"输入控件<input>4",1,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200})
TracePrint(objElement)

可视化样例