EtsT_Pj_Scenarios_Manage_Event_Callback
**注意:**需要 OPNET Development Kit
摘要
回调:当在指定的 Manage Scenarios 对话框中单击 OK 或 Cancel 按钮时被调用。
语法
<scenarios_manage_event_callback_name> (handle, event_type, client_data, event_data)
| 参数 | 类型 | 说明 |
|---|---|---|
handle |
EtsT_Pj_Scenarios_Manage_Handle |
相关的 Manage Scenarios 对话框。 |
event_type |
EtsT_Pj_Scenarios_Manage_Event |
触发此回调的事件类型;为表 36 中的常量之一(见event_type)。 |
client_data |
void * |
注册回调时用户指定的状态信息。 |
event_data |
void * |
事件相关数据(见event_data) |
返回类型
EtsT_Pj_Scenarios_Manage_Event_Result
回调处理的结果(见详情)。
头文件
ets_api_pj.h
示例
EtsT_Pj_Scenarios_Manage_Event_Result
manage_event_proc (EtsT_Pj_Scenarios_Manage_Handle manage_hndl,
EtsT_Pj_Scenarios_Manage_Event event_type,
void *client_data, void *event_data)
{
EtsT_Pj_Scenarios_Manage_Event_Result result =
EtsC_Pj_Scenarios_Manage_Event_Result_Continue;
PrgT_List *table_info_lptr;
EtsT_Pj_Scenarios_Manage_Table_Info *table_info_ptr;
int inx, table_row_num;
FIN (manage_event_proc);
switch (event_type)
{
case EtsC_Pj_Scenarios_Manage_Event_Ok_Begin:
printf ("OK Begin event...\n");
table_info_lptr = Ets_Pj_Scenarios_Manage_Table_Info_Get (manage_hndl);
table_row_num = prg_list_size (table_info_lptr);
for (inx = 0; inx < table_row_num; inx++)
{
table_info_ptr = prg_list_access (table_info_lptr, inx);
printf ("Table row %i, scenario <%s> ...\n", inx,
table_info_ptr->name);
if (table_info_ptr->flags & ETSC_PJ_SCENARIOS_MANAGE_INFO_NEW)
printf ("This is a new scenario.\n");
if (table_info_ptr->flags & ETSC_PJ_SCENARIOS_MANAGE_INFO_DELETE)
printf ("This scenario will be deleted.\n");
if (table_info_ptr->flags & ETSC_PJ_SCENARIOS_MANAGE_INFO_RENAME)
printf ("This scenario was renamed from <%s>\n",
table_info_ptr->orig_name);
if (table_info_ptr->duplicate)
printf ("This scenario will be a duplicate of <%s>\n",
table_info_ptr->duplicate);
Ets_Pj_Scenarios_Manage_Table_Info_Destroy (table_info_ptr);
}
prg_list_destroy (table_info_lptr, PRGC_FALSE);
break;
case EtsC_Pj_Scenarios_Manage_Event_Ok_End:
printf ("OK End event...\n");
break;
case EtsC_Pj_Scenarios_Manage_Event_Cancel:
printf ("Cancel event...\n");
break;
case EtsC_Pj_Scenarios_Manage_Event_Collect:
printf ("Collect event...\n");
break;
case EtsC_Pj_Scenarios_Manage_Event_Discard:
printf ("Discard event...\n");
break;
default:
printf ("*** Unknown manage event ***\n");
}
FRET (result);
}
详情
此回调应处理 OK 和 Cancel 按钮,以及为 Manage Scenarios 对话框指定的任何自定义或系统按钮。
event_type
event_type 的各个取值含义如下:
EtsC_Pj_Scenarios_Manage_Event_Cancel——用户单击了 Cancel 按钮EtsC_Pj_Scenarios_Manage_Event_Ok_Begin——用户单击了 OK 按钮,且 Core 尚未执行任何操作 处理此事件类型时,回调可以对handle调用 Ets_Pj_Scenarios_Manage_Table_Info_Get(),获取将为每个场景执行哪些操作的信息。EtsC_Pj_Scenarios_Manage_Event_Ok_End——用户单击了 OK 按钮,且 Core 已完成所有必需的操作EtsC_Pj_Scenarios_Manage_Event_Collect——用户选择为一个或多个场景收集仿真结果EtsC_Pj_Scenarios_Manage_Event_Discard——用户选择为一个或多个场景丢弃仿真结果
event_data
event_data 的值取决于以下情况:
- OK_Begin、OK_End 和 Cancel 事件——
OPC_NIL - Collect 和 Discard 事件——场景名称(数据类型为
char *)
此回调应返回下列值之一:
EtsC_Pj_Scenarios_Manage_Event_Result_Handled——回调已完成该事件所需的处理,Core 不应对此事件采取任何操作EtsC_Pj_Scenarios_Manage_Event_Result_Continue——回调已完成其处理,Core 应继续对此事件执行所需的处理
该回调由 Ets_Pj_Scenarios_Manage() 和 Ets_Pj_Scenarios_Manage_Event_Callback_Register() 注册。