Ets_Topo_Parent_Attr_Get()
摘要
根据对象句柄和属性名称,获取顶层属性的值。
语法
Ets_Topo_Parent_Attr_Get (child_obj_hndl, attr_name, result_value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
child_obj_hndl |
EtsT_Obj_Handle |
子对象的句柄。 |
attr_name |
const char * |
所关注的顶层属性的名称。 |
result_value_ptr |
void * |
所关注属性的值。(关于此参数的详情参见 Ets_Obj_Attr_Get()(第 958 页)。) |
返回类型
EtsT_Compcode
若获取到属性值,返回 EtsC_Compcode_Success;否则返回 EtsC_Compcode_Failure。
头文件
ets_api_topo.h
详情
在使用活动属性时,使用此函数获取顶层属性的值。
通常,你会组合使用 Ets_Topo_Parent_Get() 和 Ets_Obj_Attr_Get(),先获取属性的父对象,再获取属性的值。然而,对于顶层属性,Ets_Topo_Parent_Get() 返回的是原始对象的句柄,而不是该对象的工作副本。因此,对顶层属性值的修改是直接作用于原始对象的,不会立即反映在 GUI 中。此函数通过操作对象的工作副本避免了该问题。
注意: 在不涉及顶层属性和活动属性的场景下,组合使用 Ets_Topo_Parent_Get() 和 Ets_Obj_Attr_Get() 效率更高,应当优先于 Ets_Topo_Parent_Attr_Get() 使用。