创建新的对话框

按照以下总体过程创建一个新的对话框。

过程 13:打开编辑器并为对话框命名

  1. 使用 OPNET Development Kit 运行 NetPlanner。

  2. 选择 File > New > Dialog Box Resource File,启动对话框资源文件编辑器(op_etsed)。你可以创建该编辑器的多个独立实例。

  3. 为将要创建的资源文件输入名称。

    一个资源文件由一个顶层字典构成,字典是对话框及其他可视元素的文件夹。字典允许你将相关组件组织为组。你还可以创建子字典,以便在单个文件中进一步组织组件。

    *结果:*对话框资源文件编辑器打开,同时显示 op_etsed 主窗口和资源文件编辑器。

    op_etsed 主窗口与资源文件编辑器

  4. 在资源文件编辑器中创建一个新的对话框对象。在资源文件编辑器中,选择 Resource > New > Dialog。

    *结果:*创建了一个新的对话框对象,并显示在 Dictionary 页面中。

    **注:**ETS API 只能访问类型为 Dialog 的对话框。请确保你插入的对象是“Dialog”对象。

    Dictionary 页面中的新对话框对象

  5. 为对话框命名。单击对话框对象所在的 Tag 列,然后输入标签名称。这一步很重要,因为 ETS API 使用该标签引用特定的对话框。位于嵌套字典中的对话框按如下方式引用:<level_1_dict_name>/<level_2_dict_name>/.../<dialog_tag>。

你将在两个编辑器中定义对话框的基本信息:对话框编辑器和容器编辑器。

图 16:对话框编辑器与容器编辑器

对话框编辑器与容器编辑器

**注:**打开 ETS 对话框进行编辑时,容器编辑器也会自动打开。但关闭容器编辑器时,对话框编辑器不会自动关闭。

对话框编辑器允许你查看和指定对话框的一般信息。每个标签页可输入不同类型的信息:

  • Window——设置对话框与窗口的一般信息,如 tag、title 和 size
  • Dialog Attributes——指定支持文件,如帮助文件和 ETS 回调过程(处理器)
  • Order Items——以列表视图显示所有顶层控件
  • Dialog——显示对话框的可视化布局

图 17:对话框编辑器中的标签页

对话框编辑器中的标签页

过程 14:打开对话框编辑器与容器编辑器

  1. 在资源文件编辑器中,双击 Tag 列或 Type 列中的图标。

    双击 Tag 列或 Type 列中的图标

    *结果:*对话框编辑器和容器编辑器同时打开。

  2. 按如下方式指定 ETS 库和默认事件处理器。

    2.1 如果 Dialog Attributes 页面不可见,单击 Dialog Attributes 标签。

    *结果:*Dialog Attributes 页面移到最前面。
    

    2.2 在 ETS Library 字段中指定文件名。不要包含后缀;例如,如果你的库的文件名为 my_library.gui32.i0.ets.dll(或 my_library.gui32.i1.ets.so),则只输入 my_library。 2.3 在 ETS Event Proc 字段中指定默认事件处理器函数。 2.4 如果对话框将带有帮助按钮,在 HTML Help File 字段中输入帮助文件名。

    Dialog Attributes 页面的各字段

  3. 指定 tag 和 title。

    3.1 单击 Window 标签。

    *结果:*出现 Window 页面。
    

    3.2 在 Tag 和 Title 字段中输入字符串。

    Window 页面的 Tag 与 Title 字段

接下来,在容器编辑器中定义对话框的一般信息。

每个对话框内部都有一种称为 lining 的特殊容器控件。所有 ETS 控件都必须位于 lining 内部。Riverbed 编辑器对话框的菜单栏、工具栏和状态栏位于 lining 之外,但 ETS 目前不支持这些控件。初次创建对话框时,它只有一个容器。你可以在 lining 内部添加其他容器,以进一步组织活动控件。

不应删除、重命名或以其他方式重新配置 lining 本身(lining 自身的弹簧连接应为:四边是零长度的锁定固定支柱,宽度和高度方向是完整弹簧)。应在对话框(而不是 lining)上设置属性(如 Resizable)。

容器编辑器允许你查看和指定对话框容器的一般信息。每个标签页可输入不同类型的信息:

  • Dialog Item——设置对话框容器的一般信息,如 tag、title 和 size
  • Container Attributes——添加滚动条及其他对话框级别的属性
  • Order Items——以列表视图显示所有顶层控件
  • Container——编辑对话框的布局

图 18:容器编辑器中的标签页

容器编辑器中的标签页

过程 15:编辑容器

  1. 使容器编辑器成为活动窗口。

  2. 如果 Container 页面不可见,单击 Container 标签。

    **注:**容器编辑器与对话框编辑器看起来相似,但控件必须添加在这里,即顶层容器中,ETS 才能看到它们。

  3. 插入 UI 控件。可以通过两种方式做到这一点。推荐使用 Item Palette(项面板)方式,因为以这种方式添加的控件具有合理的默认值和内部弹簧连接。如果通过菜单添加控件,则需要手动设置这些参数。

    通过 Item Palette 添加控件。

    3.1 选择 Windows > Item Palette 打开项面板。 3.2 使用与构建网络模型时操作对象面板相同的拖放方法。 3.3 通过添加或删除控件来自定义项面板。要向项面板添加控件,选择 File > New Item(在 Item Palette 的菜单栏中),然后从子菜单中选择控件类型。要删除控件,选中它并选择 Edit > Clear。

    通过菜单添加控件。

    3.1 选择 Container > New Item > <control type>。

  4. 使用每种活动控件对应的专用编辑器,为其指定事件处理器。标签、线条、方框或图标控件无需指定事件处理器。

    4.1 在容器编辑器中双击控件,打开 <control_type> 编辑器。

    *结果:*`<control_type>` 编辑器打开。
    
    **图 19:`<control_type>` 编辑器示例(Checkbox)**
    
    ![控件类型编辑器示例(Checkbox)](../../images/main_documentation/odk_16_dboxed.104.2.09.jpg)
    

    4.2 单击 <control_type> 标签。 4.3 在 ETS Action Proc 字段中输入事件处理器函数。该函数必须定义在你分配给该对话框的 ETS 库中。

  5. 为控件指定 tag。这一步很重要,因为 ETS API 使用 tag 来访问特定的用户界面(UI)控件及其底层数据。要指定 tag:

    5.1 单击 Dialog Item 标签。

    *结果:*出现 Dialog Item 页面。
    
    ![Dialog Item 页面](../../images/main_documentation/odk_16_dboxed.104.2.10.jpg)
    

    5.2 在 Tag 字段中输入字符串。如果你希望通过 ETS 访问某个控件,对话框中每个控件都应有唯一的 tag。

    你可能还想为所创建的控件类型指定其他合适的设置。例如,如果创建的是按钮,就需要指定 title。title(如“OK”或“Cancel”)显示在按钮上,向用户表明其功能。
    
    指定完设置后,关闭 Dialog Item 编辑器并返回容器编辑器。
    
  6. 在容器编辑器中放置并排列 UI 控件。每个 UI 控件都有一组连接,用于确定控件的大小并定位其在容器中的位置。详见在对话框中排列控件。

  7. 测试对话框的布局。

    7.1 在对话框编辑器中,单击 Dialog 标签

    *结果:*出现 Dialog 页面。
    

    7.2 选择 Dialog > Try Dialog,查看“实时”对话框的外观。

  8. 保存对话框并退出 op_etsed。

  9. 创建并编译一个 ETS 库。这是一个 ETS 目标文件(.ets.dll 或 .ets.so),包含对话框的事件处理器。每个对话框只能定义一个库。因此,必须将对话框的所有事件处理器包含在同一个库中。有关为对话框创建事件处理器的更多信息,参见第 245 页的“Creating Dialog Boxes”。