Ets_Pj_Scenarios_Manage()
**注意:**需要 OPNET Development Kit
摘要
打开一个带自定义按钮和列的场景管理对话框。
语法
Ets_Pj_Scenarios_Manage (button_definition_lptr, callback, num_columns, column_names [], options, client_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
button_definition_lptr |
PrgT_List * |
自定义按钮定义列表(参见 button_definition_lptr)。 |
callback |
EtsT_Pj_Scenarios_Manage_Event_Callback |
处理用户输入响应的回调。 |
num_columns |
int |
对话框中包含的列数。 |
column_names [] |
char * |
列名称数组。 |
options |
int |
要包含在对话框中的标准系统按钮(参见 options)。 |
client_state_ptr |
void * |
传递给回调的用户指定状态信息。 |
返回类型
EtsT_Pj_Scenarios_Manage_Handle
用于在当前项目中管理场景的状态信息。
头文件
ets_api_pj.h
详情
此函数创建一个场景管理状态及相关的 Manage Scenarios 对话框。该对话框是阻塞式的;在它打开期间无法执行其他操作。使用 Ets_Pj_Scenarios_Manage_Dbox_Get() 可获取此函数创建的 Manage Scenarios 对话框的引用。
您可以使用此函数显示用于管理场景的定制对话框。为此,通常需要编辑应用程序的 .ets 文件,将标准的 Scenarios > Manage Scenarios 菜单项替换为调用此函数的自定义菜单项。
作为创建定制场景管理对话框的替代方案,您也可以重新定义标准 Manage Scenarios 对话框的功能;详情参见 Ets_Pj_Scenarios_Manage_Event_Callback_Register()。
button_definition_lptr
button_definition_lptr 是要包含在对话框中的自定义按钮列表。列表中的每个元素都是用 Ets_Pj_Scenarios_Manage_Button_Def_Create() 创建的按钮定义。
options
options 必须是 ETSC_PJ_SCENARIOS_MANAGE_OPT_NONE,或以下一个或多个常量按位 OR 组合的结果:
- ETSC_PJ_SCENARIOS_MANAGE_OPT_DISCARD_BUTTON
- ETSC_PJ_SCENARIOS_MANAGE_OPT_COLLECT_BUTTON
- ETSC_PJ_SCENARIOS_MANAGE_OPT_COLLECT_ALL_BUTTON
- ETSC_PJ_SCENARIOS_MANAGE_OPT_DELETE_BUTTON
callback_proc 的原型见 EtsT_Pj_Scenarios_Manage_Event_Callback。