模型处理器
模型处理器允许模型开发者在模型实例(例如节点或链路对象)被点击、创建或销毁时,覆盖用户界面的默认行为。
您可以为以下事件创建模型处理器函数:
- 当用户在网络中左键点击、中键点击或双击某个对象时(点击处理器,click handler)
- 当用户在网络中右键点击某个对象时(菜单显示处理器,menu display handler)
- 当用户从对象弹出菜单中选择某一项时(菜单选择处理器,menu choose handler)
- 当某个对象被创建时(对象创建处理器,object creation handler)
- 当某个对象被销毁时(对象销毁处理器,object destruction handler)
这些处理器应用于模型的特定实例。此外,ETS 还支持模型范围点击处理器(列于表 7中)。如果注册了模型范围点击处理器,该处理器会在每个对象的点击处理器之前拦截点击事件(BEFORE)。如果模型范围处理器返回的状态码指示 ODK 应用程序继续处理该点击,则每个对象的点击处理器仍可以被调用。
表 7:模型范围点击处理器
| 处理器 | 注册方式 |
|---|---|
| 点击 | Ets_Nt_Click_Callback_Register() |
| 双击 | Ets_Nt_Double_Click_Callback_Register() |
| 菜单定义(右键点击) | Ets_Nt_Menu_Define_Callback_Register() |
| 菜单选择 | Ets_Nt_Menu_Select_Callback_Register() |
处理器函数名称与其模型一起存储,并在 Network Editor 中创建该模型的实例时与特定对象关联。
注意: 对模型定义中 ETS 处理器信息的更改会影响该模型的所有实例,包括已经创建的模型实例。
使用过程 12可以指定模型处理器。
过程 12:指定模型处理器
-
使用下列方法之一打开 Enter ETS Handlers 对话框。
对于节点
1.1 在 Node Model Editor 中,选择 Interfaces > Node Interfaces。
1.2 在 Node Interfaces 对话框中,点击 ETS Handlers 按钮。
出现用于节点接口的 Enter ETS Handlers 对话框。 对于链路、路径或需求
1.1 在 Link Model、Path Model 或 Demand Model 编辑器中,点击 ETS Handlers 按钮。
出现用于链路、路径和需求接口的 Enter ETS Handlers 对话框。  -
在 Enter ETS Handlers 对话框中,输入以下信息。
- 在 Library 字段中,输入包含处理器函数的文件名称(不含后缀)。
- 在各处理器字段中,输入相应的处理器函数名称。
注意: 必须在 Library 字段中给出有效的文件名称,才能分配处理器函数。
-
点击 OK。
注意: 对 ETS 处理器的更改在您保存模型之后才会生效。
模型点击处理流程图
后续页面中的流程图(图 12至图 14)描述了用户在绘图区中点击鼠标时发生的事件顺序。点击的类型(右键、左键、单击或双击)、被点击的对象(节点、链路、子网或菜单),以及点击处理器是由内部定义还是由用户定义,都会影响随后发生的动作。
以下说明中的编号对应流程图中编号相同的步骤。
当用户点击鼠标时,Riverbed 首先检查是否已通过 Ets_Nt_Click_Callback_Register() 注册了点击回调 (1)。如果已注册,则调用用户定义的回调 (2)。如果该回调返回非零值,Riverbed 认为该点击已被处理,并退出点击代码块 (3)。如果回调返回 0,Riverbed 接着考虑点击的类型,并采取相应的动作 (4)。
双击
如果用户在绘图区中双击,Riverbed 首先确认是否已通过 Ets_Nt_Double_Click_Callback_Register() 注册了双击回调 (5)。如果已注册,则调用该回调 (6);如果它返回 0,则该点击被视为已处理 (7)。如果回调返回 1,或者因为没有注册回调而未调用任何回调,则该点击由内部处理,默认行为发生。
如果由内部函数处理该点击,Riverbed 首先检查被点击的是哪种类型的对象 (9)。如果该对象是子网,则取消选择所有已选中的网络对象,并且网络编辑器中的视图更改为显示被双击子网的内容 (10)。如果该对象是子网以外的其他对象,Riverbed 检查是否由被点击站点的“模型”定义了处理器 (11)。如果已定义,则调用该站点的“点击”回调 (12)。该回调返回 EtsC_Obj_Click_Handled,表示点击已被成功处理 (13);或者返回 EtsC_Obj_Click_Continue,此时 Riverbed 以默认方式处理该点击 (14)。如果没有注册站点点击回调,也会发生相同的行为。
右键点击
当用户右键点击某个对象时,Riverbed 创建初始的弹出菜单文本列表 (15)。然后 Riverbed 检查是否已通过 Ets_Nt_Menu_Define_Callback_Register() 注册了菜单定义回调 (16)。如果已注册,则调用全局菜单显示回调 EtsT_Nt_Menu_Define_Callback() (17)。如果全局菜单显示回调的返回值为 0,则认为该点击未被处理,流程退出 (18)。另一方面,如果返回值非零,或者未注册全局菜单显示回调,则 Riverbed 检查是否注册了模型专用的菜单显示回调 (19)。由于该回调由被点击对象的模型定义,它内部于特定的对象实例。如果已注册模型专用的菜单显示回调,则调用模型专用的“菜单显示”回调 (20)。如果该回调返回 EtsC_Obj_Click_Handled,则点击已被正确处理,代码退出 (21)。如果返回 EtsC_Obj_Click_Continue,或者没有注册模型专用的菜单显示回调,则显示菜单,Riverbed 等待用户的响应 (22)。
用户做出选择后,Riverbed 检查是否已通过 Ets_Nt_Menu_Select_Callback_Register() 注册了全局菜单选择回调 (23)。如果已注册,则调用全局“菜单选择”回调 (24),如果它返回非零值,则选择已被成功处理,代码退出 (25)。如果回调返回零,或者未注册全局菜单选择回调,Riverbed 检查模型的菜单选择回调是否在 ETS Handlers 对话框的 Menu Choose Handler 选项中注册(该回调内部于站点实例模型)(26)。如果已注册回调,则调用模型的“菜单选择”回调 (27)。返回 EtsC_Obj_Click_Handled 表示回调已成功完成,随后代码退出 (28);返回 EtsC_Obj_Click_Continue 表示 Riverbed 内部处理菜单项选择,该点击已被处理 (29)。如果未注册站点菜单选择,Riverbed 同样会内部处理菜单项选择。
左键点击
如果检测到左键点击,该点击通常由 Riverbed 内部处理。不过,Riverbed 仍会先检查是否注册了站点点击回调 (30),如果已注册,则调用该回调 (31)。如果回调返回 EtsC_Obj_Click_Handled,则点击已被正确处理,代码退出 (32)。如果回调返回 EtsC_Obj_Click_Continue (33),或者没有注册任何回调,Riverbed 将内部处理该点击,被点击对象(节点、链路或路径)的最终动作是被选中或被取消选中。
图 12:模型点击处理流程图(第 1 部分)

图 13:模型点击处理流程图(第 2 部分)

图 14:模型点击处理流程图(第 3 部分)

模型处理器函数说明
以下各表描述了五种模型处理器函数的特性与要求。有关创建库文件的信息,另参见《构建代码库》(第 13 页)。