awtk/docs/manual/file_dialog_t.md

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*	初始目录。