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() 修改,就像内置属性一样。