netbiz.ets 文件

如果你要构建 Netbiz 应用,你需要将 netbiz.ets 文件放在 mod_dirs 偏好设置所列的某个目录中。有关该文件应放置的位置,参见File Organization。

netbiz.ets 文件用于:

  • 定义 Netbiz 项目中将可用的各个编辑器。
  • 指定可用的资源文件,这些资源文件包含使用 Dialog Box Editor 创建的自定义对话框(op_etsed.)。
  • 指定可用的图标数据库,这些数据库由图标编辑器创建。
  • 指定 Netbiz 工具启动时将调用的函数的名称。
  • 指定显示在主 Netbiz 工具窗口标题栏中的文本(程序横幅)。

netbiz.ets 文件是编辑器配置文件的一个示例。编辑器配置文件声明一系列编辑器。每个要在你的应用中出现的编辑器,都必须在编辑器配置文件中有一个条目。该文件的默认版本名为 netbiz.ets,存储在 <reldir>/sys/configs 目录中;不过,它可以存储在 mod_dirs 偏好设置所包含的任何目录中。

当你启动应用时,它会读取编辑器配置文件,以确定向用户提供哪些工具。通过向编辑器配置文件添加条目,你可以向界面添加更多工具。所有额外的工具都必须基于现有的工具类型。通过删除编辑器配置文件中的条目,你可以从用户界面中移除工具。

示例 netbiz.ets 文件分析

下面的示例 netbiz.ets 文件将使你的应用会话包含系统菜单(应用启动后即存在)、License Manager 和 Network Editor。

注: 此处显示的文件并非实际文件,仅作示例说明。

图 6:示例 netbiz.ets 文件

示例 netbiz.ets 文件

netbiz.ets 文件结构

netbiz.ets 文件(以及任何编辑器配置文件)使用如下结构:

  • 第一行将该 ETS 脚本标识为编辑器配置文件。
  • 第一行之后是全局参数,其形式为 <attribute name>: <attribute value>。
    • program_banner。该属性指定一个将显示在应用窗口标题栏中的字符串。该字符串必须放在引号内。如果指定了 program_banner 偏好设置(例如在偏好设置文件中),其值将覆盖该属性。
    • icon_dbs。该属性指定一个或多个图标数据库文件(以逗号分隔),这些文件将在启动时加载。这些图标数据库文件必须位于当前的模型目录中。这些图标数据库文件可以在 ODK 应用内部创建和编辑。如果指定了 icon_dbs 偏好设置(例如在偏好设置文件中),该列表将被添加到这个列表中。
    • program_resources。该属性指定一个或多个用户界面资源文件(以逗号分隔),这些文件将被搜索对话框描述。这些资源文件必须位于当前的模型目录中。你可以使用 op_etsed 工具创建和编辑资源文件。
    • ets_initialization。该属性指定一个或多个 ETS 库文件(以逗号分隔),这些文件将在程序启动时加载,并调用其初始化函数。初始化函数必须名为 <ets_library_name>_ets_init,不接受参数,也不返回值。这些 ETS 库文件必须位于当前的模型目录中。
  • 全局参数之后是工具条目定义块。每个条目定义以“start_editor”行开始,以“end_editor”行结束。在这两行之间,以 <attribute name>: <attribute value> 的形式给出描述该工具的属性。
    • name。该属性是 ODK 应用内部使用的唯一字符串。
    • base_type。该属性是该工具条目所基于的默认工具的名称。表 3列出了该属性的有效值。
    • title。该属性是 ODK 应用显示在工具窗口标题栏中的字符串。因此,它应当是对用户有意义的词语或短语。该字符串必须放在引号内。
    • operation_list_files。该属性指向配置工具菜单和菜单项的 ETS 文件。你可以通过用逗号分隔文件名或重复该属性来包含多个操作列表文件。
    • startup_function_library。该属性指定单个 ETS 库文件,当打开此类型的编辑器(目前仅指 base type 为“project”的编辑器)的新文件(而非已有文件)时加载该文件。加载该库是为了调用其启动函数。启动函数必须名为 <ets_library_name>_ets_startup,不接受参数,也不返回值。该 ETS 库文件必须位于当前的模型目录中。
  • 以“#”作为行首字符的行被视为注释,将被忽略。

表 3:工具基础类型

属性值 对应工具
System system window
ace Application Characterization Editor
anim Animation Viewer (op_vuanim)
antenna Antenna Pattern Editor(需要 Wireless 模块)
etsconfig ETS Configuration File Editor
etssrc ETS Source Editor(C 代码)
etssrc_cpp ETS Source Editor(C++ 代码)
extsrc External Source Editor(C 代码)
extsrc_cpp External Source Editor(C++ 代码)
filter Filter Editor
gdf Generic Data File Editor
ici ICI Editor
icon Icon Database Editor
licenseman License Manager
link Link Model Editor
modulation Modulation Curve Editor(需要 Wireless 模块)
network Network Model Editor
node Node Model Editor
orb Orbit Viewer (op_vuorb)(需要 Wireless 模块)
packet Packet Format Editor
path Path Model Editor
pdf PDF Editor
plstage Pipeline Stage Editor(C 代码)
plstage_cpp Pipeline Stage Editor(C++ 代码)
probe Probe Model Editor
process Process Model Editor
project Project Editor
simulation Simulation Sequence Editor
wrc Dialog Box Resource File Editor (op_etsed)

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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