获取父元素

命令说明

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

命令原型

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

命令参数

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

可视化样例