包概述

以下主题说明如何使用下列子包:

Domain 子包

Domain 子包支持从树形视图(treeview)到域的拖放操作。这使你可以在用户将光标从树形视图拖到域上、或将从树形视图拖出的对象放置到域上时提供自定义动作。这种拖放功能的一个典型用途是:从基于树的调色板或菜单中拖动对象,将其安装到网络域或图形域中。

Icon 子包

Icon 子包包含用于一般图标相关活动以及使用托管图标(managed icon)的函数。你可以按名称获取图标,使用 Ets_Icon_Find()。要以各种格式(如 GIF 或 PNG)导出图标图像,使用 Ets_Icon_Export()。要打开图标调色板,使用 Ets_Icon_Palette_Create()。

此包中的许多函数支持托管图标,即可以从文本字符串动态创建的图标。它们适用于在项目工作区中可视化数据。你可以使用 Ets_Icon_From_Text_Create() 或 Ets_Icon_From_Textlist_Create() 创建托管图标。托管图标具有用于跟踪其使用情况的引用计数,从而在不再被使用时自动销毁。每次在可视化中使用一个托管图标时,通过调用 Ets_Icon_Reference() 将其引用计数加一。当图标从可视化中移除时,使用 Ets_Icon_Unreference() 将其引用计数减一。此函数包含一个选项,可防止未使用的图标被自动销毁。对于未被自动销毁的图标,可以调用 Ets_Icon_Unreferenced_Destroy() 将其销毁。

Progress Bar 子包

当执行耗时较长的操作时,使用进度条让用户了解操作进度会有帮助。Progress Bar 子包允许你管理多个同时存在的进度条。所有进度条都显示在一个对话框中,并且每个都可以单独中止。此 API 最多支持 5 个同时存在的进度条;但我们建议最多使用 2 或 3 个(出于可用性考虑,并为子进程留出显示进度条的可能)。

你可以使用 Ets_Progress_Bar_Handle_Start() 打开新的进度条。进度条打开后,可以使用 Ets_Progress_Bar_Handle_Advance() 对其进行更新,该函数还会检查该进度条的 Cancel 按钮(如果处于活动状态)是否被按下。你可以使用 Ets_Progress_Bar_Handle_Current_Get() 查看进度条的当前设置,或使用 Ets_Progress_Bar_Handle_Progress_Set() 指定绝对进度值。

如果需要修改已打开的进度条,可以使用 Ets_Progress_Bar_Handle_Max_Set() 更改最大值,或使用 Ets_Progress_Bar_Handle_Title_Set() 更改标题。你可以使用 Ets_Progress_Bar_Handle_Reset() 将进度条重置为零(同时还可以更改最大值、标题或可中止状态)。

进度条可以是不确定的(indeterminate),即没有定义最大值。不确定进度条以"barber pole"(理发店旋转条)图案显示,而不是显示具体数值。在确定任务范围期间,可以将不确定进度条用作占位显示。

要创建不确定进度条,使用 Ets_Progress_Bar_Handle_Start() 并将 max_value 设为 ETSC_PROGRESS_BAR_INDETERMINATE。要动画显示 barber pole 图案,反复使用 Ets_Progress_Bar_Handle_Advance() 或 Ets_Progress_Bar_Handle_Progress_Set() 设置进度条的进度。准备就绪后,可以使用 Ets_Progress_Bar_Handle_Reset() 设置最大值,使进度条变为确定型。

已打开的进度条可以使用 Ets_Progress_Bar_Handle_End() 关闭。

除上述函数外,Riverbed Modeler 仍然支持用于单个进度条的原始函数(源自 10.5 及更早版本)。但我们建议在新代码中不要使用这些函数:

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com