Ets_Icon_From_Text_Create()
注意: 需要 OPNET Development Kit
摘要
创建一个表示指定文本字符串的图标。
语法
Ets_Icon_From_Text_Create (icon_name, text_value, fg_color, bg_color, options)
| 参数 | 类型 | 说明 |
|---|---|---|
icon_name |
const char * |
图标名称。 |
text_value |
const char * |
图标中表示的文本字符串(见详情)。 |
fg_color |
EtsT_Color |
图标中文本的前景色。 |
bg_color |
EtsT_Color |
图标中文本的背景色。 |
options |
int |
未使用;设为 ETSC_ICON_CREATE_OPT_NONE。 |
返回类型
EtsT_Icon *
指向新图标的指针;失败时返回 PRGC_NIL(例如已存在同名图标)。
头文件
ets_api_icon.h
详情
该函数动态创建一个表示字符串 text_value 的图标。字符串格式可以是简单字符串,也可以是 ChartDirector Mark Up Language 文本。该标记语言允许你指定格式和嵌入图像。例如,字符串
Test<*img=foo.gif*>
将生成一个由字符串 “Test” 后接指定图像组成的图标。图像文件必须位于 sys/images 目录中。
新创建的图标被放入默认动态图标数据库。当调用 Ets_Icon_Unreference() 且其引用计数为 0 时,该图标将被销毁。图标创建时的初始引用计数为 0。如果客户端持有该图标的引用,应调用 Ets_Icon_Reference() 将引用计数增加到 1。