op_anim_viewer_close()
摘要
关闭指定查看器:移除其窗口并释放其所有保留图形及其他内存。
语法
op_anim_viewer_close (anvid)
| 参数 | 类型 | 说明 |
|---|---|---|
anvid |
Anvid |
查看器 ID [该值是数值标识符,引用要关闭的查看器。] |
返回类型
void
无返回值
示例
/* Determine interrupt type. */
itype = op_intrpt_type ();
/* Check for node failure interrupt. */
if (itype == OPC_INTRPT_FAIL)
{
/* Node is dead; close associated animation viewer and macros. */
op_anim_viewer_close (local_vid);
op_anim_macro_destroy (local_move_mid);
op_anim_macro_destroy (local_comm_mid);
}
详情
在仿真过程中一旦某查看器被本内核过程关闭,就不应再调用引用该已关闭查看器 ID(anvid)的 Anim 包内核过程。
除参考小节列出的查看器 ID 来源外,符号常量 OPC_ANIM_ANVID_PBSPEC 也可用作替代查看器 ID,表示应从活动的无标签自定义动画探针获取真实的查看器 ID。
用途
提供一种在动画过程中移除查看器窗口的机制。当某查看器在某个时间之后不再显示任何有价值的信息时,这很有用——否则它只会占用本可用于其他查看器的宝贵屏幕空间。
错误
- 诊断错误:动画查看器 ID(
<anvid>)超出范围。(由于anvid参数的值无效)
参考
- 使用内核过程
op_anim_viewer_open()或op_anim_viewer_open_std()创建动画查看器并获取其 ID,或使用内核过程op_anim_lprobe_anvid()获取由带标签自定义动画探针打开的查看器 ID