Ets_Icon_From_Textlist_Create()
注意: 需要 OPNET Development Kit
摘要
创建一个表示指定文本字符串列表的图标。
语法
Ets_Icon_From_Textlist_Create (icon_name, text_lptr, fg_color, bg_color, options)
| 参数 | 类型 | 说明 |
|---|---|---|
icon_name |
const char * |
图标名称。 |
text_lptr |
PrgT_List * |
图标中表示的文本列表(见详情)。 |
fg_color |
EtsT_Color * |
图标中文本的前景色数组(大小必须与 text_lptr 相同)。 |
bg_color |
EtsT_Color * |
图标中文本的背景色数组(大小必须与 text_lptr 相同)。 |
options |
int |
未使用;设为 ETSC_ICON_CREATE_OPT_NONE。 |
返回类型
EtsT_Icon *
指向新图标的指针;失败时返回 PRGC_NIL(例如已存在同名图标)。
头文件
ets_api_icon.h
详情
该函数动态创建一个表示 text_lptr 中各字符串的图标,text_lptr 是由调用方持有的 char* 列表。各文本字符串在图标中垂直排列。
新创建的图标被放入默认动态图标数据库。当调用 Ets_Icon_Unreference() 且其引用计数为 0 时,该图标将被销毁。图标创建时的初始引用计数为 0。如果客户端持有该图标的引用,应调用 Ets_Icon_Reference() 将引用计数增加到 1。