Ema_Object_Prom_Attr_Set()

摘要

定义从下层模型或对象期望获得的提升属性(promoted attribute)的属性特性。

语法

Ema_Object_Prom_Attr_Set (model_id, object_id, attr_name, attr_properties)
参数 类型 说明
model_id EmaT_Model_Id 目标模型的数字模型 ID
[该值是引用模型的数字标识符。模型 ID 可由多个 EMA 函数获得。]
object_id EmaT_Object_Id 目标对象的数字对象 ID
[该值是引用对象的数字标识符。对象 ID 可由多个 EMA 函数获得。]
attr_name char* 提升属性的名称
attr_properties EmaT_Object_Id 该属性的特性对象的数字对象 ID

返回类型

void

无返回值。

头文件

ema.h

详情

本函数实现对象的 prom_attr_set 运算符。

通过本函数为提升属性设置值,与通过 Ema_Object_Attr_Set() 设置属性的 promote 分量不同。将对象属性的 promote 分量设为 1 会使该属性提升到更高层的对象。Ema_Object_Prom_Attr_Set() 定义期望从下层提升上来的属性的特性,但它并不实际设置该提升属性的值。调用 Ema_Object_Prom_Attr_Set() 之后,必须调用 Ema_Object_Attr_Set() 才能真正设置该属性的值。在图形编辑器或仿真中,如果对象为提升属性设置了值,而这些属性与从下层模型或对象实际提升上来的属性不匹配,则所设置的值将被丢弃并出现错误消息。

由于本函数会分配一个存储单元来保存提升属性的值,因此对同一对象的同一属性只应调用一次;对同一提升属性重复调用会导致错误。不过,一旦用本函数设置了某个提升属性,其值就可以通过 Ema_Object_Attr_Get() 查询、通过 Ema_Object_Attr_Set() 修改,就像内置属性一样。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com