创建事件处理函数
您必须创建一个高层默认事件处理器,它在对话框即将显示时被调用。您还可以创建一个控件专用事件处理器,当控件(弹出菜单、按钮、复选框、单选按钮或图标)被点击时生效。
高层处理器必须处理应用程序发送的任何消息。控件专用处理器只需处理 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 页)。