# file_dialog_t

# 概述

文件对话框。

# 函数

函数名称 说明
tk_choose_file 选择单个文件,用完后请调用TKMEM_FREE销毁返回的字符串。
tk_choose_file_for_save 选择单个文件用于保存,用完后请调用TKMEM_FREE销毁返回的字符串。
tk_choose_files 多选文件,用完后请调用darray_destroy销毁返回的数组。
tk_choose_folder 选择单个目录,用完后请调用TKMEM_FREE销毁返回的字符串。

# tk_choose_file 函数

  • 函数功能:

选择单个文件,用完后请调用TKMEM_FREE销毁返回的字符串。

  • 函数原型:
char* tk_choose_file (const char* filters, const char* init_dir);
  • 参数说明:
参数 类型 说明
返回值 char* 返回NULL表示失败,返回非NULL为文件名。
filters const char* 过滤规则(文件扩展名列表,如:".c.cpp.cxx")。
init_dir const char* 初始目录。

# tk_choose_file_for_save 函数

  • 函数功能:

选择单个文件用于保存,用完后请调用TKMEM_FREE销毁返回的字符串。

  • 函数原型:
char* tk_choose_file_for_save (const char* filters, const char* init_dir);
  • 参数说明:
参数 类型 说明
返回值 char* 返回NULL表示失败,返回非NULL为文件名。
filters const char* 过滤规则(文件扩展名列表,如:".c.cpp.cxx")。
init_dir const char* 初始目录。

# tk_choose_files 函数

  • 函数功能:

多选文件,用完后请调用darray_destroy销毁返回的数组。

  • 函数原型:
darray_t* tk_choose_files (const char* filters, const char* init_dir);
  • 参数说明:
参数 类型 说明
返回值 darray_t* 返回NULL表示失败,返回非NULL为文件名列表。
filters const char* 过滤规则(文件扩展名列表,如:".c.cpp.cxx")。
init_dir const char* 初始目录。

# tk_choose_folder 函数

  • 函数功能:

选择单个目录,用完后请调用TKMEM_FREE销毁返回的字符串。

  • 函数原型:
char* tk_choose_folder (const char* init_dir);
  • 参数说明:
参数 类型 说明
返回值 char* 返回NULL表示失败,返回非NULL为文件名。
init_dir const char* 初始目录。