Ets_File_Chooser_Save_Create()

注意: 需要 OPNET Development Kit

摘要

创建一个 Save... 对话框,提示用户输入文件名。

语法

Ets_File_Chooser_Save_Create (title, options, target_dir, type_list_ptr, save_callback, close_callback, state_ptr)
参数 类型 说明
title const char * 对话框标题
options int 文件选择器的选项(参见详情)
target_dir const char * 要显示的初始目录的路径
type_list_ptr PrgT_List * 形如 <type name> (extension1; extension2; …) 字符串的 Prg 列表。例如 Network (.nt.m) 或 Text File (.txt; *.gdf; *.ets)。
save_callback EtsT_File_Chooser_Ok_Proc 用户单击对话框中的 “Save” 按钮时调用的过程(回调原型参见 EtsT_File_Chooser_Ok_Proc)
close_callback EtsT_File_Chooser_Close_Proc 用户单击 “Cancel” 或保存成功时调用的过程(回调原型参见 EtsT_File_Chooser_Close_Proc)
state_ptr void * 用户自定义数据,每次调用 save_callback 和 close_callback 时都会将其传递给回调。

返回类型

EtsT_Compcode

若文件选择器的 Save 对话框创建成功,返回 EtsC_Compcode_Success;否则返回 EtsC_Compcode_Failure。

头文件

ets_api_gui.h

详情

options 必须为 ETSC_FILE_CHOOSER_OPT_NONE 或下列符号常量的按位 OR 组合:

  • ETSC_FILE_CHOOSER_OPT_DIR—指定显示并可选择的是目录(而不是文件名)
  • ETSC_FILE_CHOOSER_OPT_PROMPT_OVERWRITE—指定若文件已存在,将提示用户是否覆盖该文件

当用户单击文件选择器中的 Save 按钮时,save_callback 被调用。以下信息被传递给回调:

  • 用户选择的路径
  • 文件类型字符串(例如 “Network (*.nt.m)”)
  • 指向 Ets_File_Chooser_Save_Create() 调用的状态指针(state_ptr 参数)

若 save_callback 返回 1,文件选择器被关闭,close_callback 被调用且 cancel_flag 置为 0。

若 save_callback 返回 0,文件选择器保持打开。

若按下 “Cancel” 按钮,close_callback 被调用且 cancel_flag 置为 1。

在文件选择器关闭之前,该函数一直阻塞。

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