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() 注册。

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