Ets_An_Panel_Trace_Add()
**注意:**需要 OPNET Development Kit
摘要
向分析面板添加一条跟踪记录。
语法
Ets_An_Panel_Trace_Add (an_panel_handle, ordinate_label, abscissa_label, draw_style, array_size, time_array, value_array)
| 参数 | 类型 | 说明 |
|---|---|---|
an_panel_handle |
EtsT_An_Panel_Handle |
面板句柄 |
ordinate_label |
const char * |
y 轴标签 |
abscissa_label |
const char * |
x 轴标签 |
draw_style |
EtsT_An_Trace_Draw_Style |
跟踪记录的绘制样式(取自表 10 Analysis Panel 子包符号常量中的一个值) |
array_size |
int |
time_array 和 value_array 两者的长度 |
time_array |
const double * |
各数据点的 x 值 |
value_array |
const double * |
各数据点的 y 值 |
返回类型
EtsT_An_Trace_Handle
新添加的跟踪记录的句柄
头文件
ets_api_an_panel.h
详情
此函数向指定面板添加一条跟踪记录。如果面板的显示模式为“stacked”(堆叠),面板上会为该跟踪记录新建一个图形;如果显示模式为“overlaid”(叠加),则将该跟踪记录添加到面板上唯一的图形中。
此函数会在跟踪记录中创建 array_size 个数据点,每个数据点都有一对 (x,y) 值。第 N 个数据点的 x 值取自 time_array 中的第 N 个值,y 值取自 value_array 中的第 N 个值。注意,time_array 和 value_array 的长度都必须不小于 array_size。
如果绘制样式为 bar、bar chart 或 sample-hold,value_array 必须以常量 ETSC_AN_PANEL_UNDEF 结尾。最后一个 y 值是未定义的,因为与之对应的 x 值仅用于确定最后一个条形的宽度或保持时间。如果 value_array 不以 ETSC_AN_PANEL_UNDEF 结尾,此函数会将 time_array,value_array 中的所有数据对都视为有效数据点,并尝试创建一个合适的最后一个 x 值(同时生成一条说明该 x 值已被创建的诊断消息)。