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。

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