创建事件处理函数

您必须创建一个高层默认事件处理器,它在对话框即将显示时被调用。您还可以创建一个控件专用事件处理器,当控件(弹出菜单、按钮、复选框、单选按钮或图标)被点击时生效。

高层处理器必须处理应用程序发送的任何消息。控件专用处理器只需处理 EtsC_Message_Control 消息。如果任一事件处理器未能处理某条消息,应用程序可能会崩溃。有关处理器的更多信息,参见《处理器原型》(第 34 页)和模型处理器。

使用默认事件处理器原型

原型如下:

DLLEXPORT void
test_event_proc (EtsT_Dbox *dbox_ptr, EtsT_Message message,
   EtsT_Submessage submessage, char *control, void *data)

该事件处理器的数据类型为 EtsT_Event_Proc。

下表列出了各个参数。在某些情况下,取决于 message 参数的取值,submessage、control 和 data 参数不会被使用。

表 5:原型参数

参数 说明
dbox_ptr 与 ETS 通信时必需的标记,用于标识调用该事件处理器的对话框。
message 要处理的事件。
submessage 事件特定信息。
control 指向一个字符串的指针,该字符串表示引发此事件的控件的 ID(如果有)。
data 指向额外事件特定数据的指针。

EtsT_Message 数据类型表示您的事件处理器可以从应用程序接收的消息。四个预定义值列于下表。

表 6:EtsT_Message 消息

消息 说明
EtsC_Message_Open 对话框正在打开;允许进行初始化。
- submessage:未使用
- control:未使用
- data:未使用
EtsC_Message_Close 对话框正在关闭;允许进行清理。
- submessage:未使用
- control:未使用
- data:未使用
EtsC_Message_Control 用户操作了某个控件。允许响应用户对对话框按钮的操作。
- submessage:EtsC_Submessage_Click。如果指定了控件专用事件处理器,则传递给该处理器;否则传递给高层处理器。
- control:控件名称的文本字符串
- data:未使用
EtsC_Message_Ping 另一个对话框发送了 ping 消息。
- submessage:未使用
- control:未使用
- data:由“ping 发起方”随 ping 消息一起发送的指针,即 EtsC_Command_Ping 的 data 参数所指定的值。

我们建议您的事件处理函数对这四个值进行 case 分支处理,如图 11所示。注意,与其他情况不同,EtsC_Message_Control 分支必须处理子消息(EtsT_Submessage 数据类型)。为便于阅读,case 语句以粗体显示。

图 11:事件处理器示例源代码

DLLEXPORT void
test_event_proc (EtsT_Dbox *dbox_ptr, EtsT_Message message,
   EtsT_Submessage submessage, char *control, void *data)
   {
   . . .
   FIN (test_event_proc (dbox_ptr, message, submessage, control, data));
   switch (message)
   {
   case EtsC_Message_Open:
/* Try to obtain information about all nodes/links in the network	*/
/* editor at the time that this dialog box is opened.		*/
   . . .
        break;
   case EtsC_Message_Ping:
/* got a ping from a sibling or child.	*/
   . . .
        break;
   case EtsC_Message_Close:
   . . .
        break;
   case EtsC_Message_Control:
        switch (submessage)
        {
        case EtsC_Submessage_Click:
        . . .
             break;
        }
        break;
   }
   FOUT;
   }

处理事件

您编写的源代码可以使用 ETS GUI 函数来实现所需的功能。参见《GUI Package》(第 243 页)。

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