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。
在文件选择器关闭之前,该函数一直阻塞。