Ets_Pj_Output_Files_Chooser_Dbox_Open()
注意: 需要 OPNET Development Kit
摘要
打开一个文件选择对话框,用于选择一个或多个输出文件。
语法
Ets_Pj_Output_Files_Chooser_Dbox_Open (in_files_lptr, chooser_callback, callback_state_ptr, dbox_title_str, ok_button_title_str, options)
| 参数 | 类型 | 说明 |
|---|---|---|
in_files_lptr |
PrgT_List * |
至少包含两个输出文件的列表,将呈现给用户。 |
chooser_callback |
EtsT_Pj_Output_Files_Chooser_Callback |
当用户在文件选择对话框中单击 OK 按钮时被调用的回调;为 OPC_NIL 时不允许选择文件(参见详情)。 |
callback_state_ptr |
void * |
用户指定的、将传递给回调过程的信息。 |
dbox_title_str |
const char * |
对话框标题。若为空,则使用默认标题“Output Files Chooser”。 |
ok_button_title_str |
const char * |
OK 按钮的标题。若为空,则使用默认标题“OK”。 |
options |
int |
对话框选项(参见 options)。 |
返回类型
void
无返回值。
头文件
ets_api_pj.h
示例
PrgT_List * result_files_lptr = prg_file_output_files_list_get (type,
project_scenario_name, suffix);
int list_size;
if (!result_files_lptr || prg_list_size (result_files_lptr) == 0)
{
// Generate error message that no results are produced.
// Result files lptr is NIL, so no need to destroy the list.
}
else if (prg_list_size (result_files_lptr)== 1)
{
<chooser_callback> (state_ptr, result_files_lptr);
//Callback destroys the result_files_lptr list, including its elements.
}
else
{
Ets_Pj_Output_Files_Chooser_Dbox_Open (result_files_lptr, call_back,
call_back_state_ptr, title_str, ok_button_title_str, options);
// Destroy the list, including its elements.
prg_list_destroy (result_files_lptr, 1);
}
详情
该函数显示一个对话框,将结果文件与调用数据(参数值)关联起来,并允许用户选择希望显示的结果。该函数的一个用途是简单地用于设置参数化研究的图表。
通常,对话框以选择模式打开,带有 OK 和 Cancel 按钮。文件列表在树形视图中按名称分层显示。如果文件代表多次仿真运行,参数值的差异显示在文件的右侧。在选择模式下,用户可以选择一个或多个文件(取决于 options),当用户单击 OK 按钮时,这些文件将由 chooser_callback 显示或作其他处理。
图 11:文件选择对话框示例(选择模式)

如果未指定 chooser_callback,对话框以显示模式打开。在此模式下,OK 和 Cancel 按钮被 Close 按钮取代,且不允许选择文件。
options
options 必须是以下常量之一:
ETSC_PJ_OUTOUT_FILES_CHOOSER_OPTIONS_NONE——只能选择一个文件ETSC_PJ_OUTOUT_FILES_CHOOSER_ALLOW_MULTIPLE_SELECTIONS——允许用户选择多个文件(默认情况下只能选择一个文件)
回调的函数原型见 EtsT_Pj_Output_Files_Chooser_Callback。