Ovis_Layer_Create()
摘要
创建一个 Ovis 层。
语法
Ovis_Layer_Create (layer_name, comment, parent_layer, show_initially, destroy_callback, user_state)
| 参数 | 类型 | 说明 |
|---|---|---|
layer_name |
const char * |
层名称 |
comment |
const char * |
指定注释 |
parent_layer |
OvisT_Layer * |
父层 |
show_initially |
OvisT_Boolean |
指定层是否初始即显示 |
destroy_callback |
OvisT_Layer_State_Destroy_Proc |
用户自定义过程,用于销毁与该对象关联的数据并释放其内存 |
user_state |
void * |
与层关联的用户自定义状态 |
返回类型
OvisT_Layer *
指向 Ovis 层的指针
头文件
ovis_layer.h
详情
该函数创建一个 Ovis 层并指定该层的各项属性。信息层提供了显示或隐藏一组相关装饰的能力,以避免动画中出现过多的图形装饰。层可以包含任意数量的装饰以及其他层。存在一个不可销毁的根层。显示一个层会显示其装饰与子层(递归显示);隐藏一个层会隐藏其装饰与子层(递归隐藏)。
示例
OvisT_Layer * root_layer, * pkt_cnt_layer;
/* root layer created elsewhere */
pkt_cnt_layer = Ovis_Layer_Create ("global packet info",
"Hold various 2D decorations representing global packet counts",
root_layer, OvisC_True, OPC_NIL, OPC_NIL);
错误
- 未提供层名称。
参考
- 使用函数
Ovis_Root_Layer_Get()可以找到根层。 - 使用函数
Ovis_Layer_Destroy()可以销毁层。