FileDialog

继承

ConfirmationDialog

简要描述

在文件系统中选择文件或目录的对话框。

描述

FileDialog是一个预设对话框，用于选择文件系统中的文件和目录。它支持过滤掩码。

成员

类型	属性名	默认值
int	access	0
String	current_dir	"res://"
String	current_file	""
String	current_path	"res://"
bool	dialog_hide_on_ok	false
PoolStringArray	filters	PoolStringArray( )
int	mode	4
bool	mode_overrides_title	true
bool	show_hidden_files	false
String	window_title	"Save a File"

方法

返回值类型	方法名称
void	add_filter(filter: String)
void	clear_filters()
void	deselect_items()
LineEdit	get_line_edit()
VBoxContainer	get_vbox()
void	invalidate()

信号

• **dir_selected**

当用户选择一个目录时发出。

---

• **file_selected**

当用户通过双击文件或按确定按钮选择文件时发出。

---

• **files_selected**

当用户选择多个文件时发出。

---

枚举

enum Mode:

• **MODE_OPEN_FILE = 0**

该对话框允许选择一个，并且只能选择一个文件。

• **MODE_OPEN_FILES = 1**

该对话框允许选择多个文件。

• **MODE_OPEN_DIR = 2**

该对话框仅允许选择目录，不允许选择任何文件。

• **MODE_OPEN_ANY = 3**

该对话框允许选择一个文件或目录。

• **MODE_SAVE_FILE = 4**

该对话框将在文件存在时发出警告。

---

enum Access:

• **ACCESS_RESOURCES = 0**

该对话框仅允许访问Resource路径(res://)下的文件。

• **ACCESS_USERDATA = 1**

该对话框仅允许访问用户数据路径(user://)下的文件。

• **ACCESS_FILESYSTEM = 2**

该对话框允许访问整个文件系统上的文件。

---

常量

成员说明

• int access

Default	0
setter	set_access(value)
getter	get_access

• String current_dir

Default	"res://"
setter	set_current_dir(value)
getter	get_current_dir

• String current_file

Default	""
setter	set_current_file(value)
getter	get_current_file

• String current_path

Default	"res://"
setter	set_current_path(value)
getter	get_current_path

• bool dialog_hide_on_ok

Default	false
setter	set_hide_on_ok(value)
getter	get_hide_on_ok

• PoolStringArray filters

Default	PoolStringArray( )
setter	set_filters(value)
getter	get_filters

• int mode

Default	4
setter	set_mode(value)
getter	get_mode

• bool mode_overrides_title

Default	true
setter	set_mode_overrides_title(value)
getter	is_mode_overriding_title

• bool show_hidden_files

Default	false
setter	set_show_hidden_files(value)
getter	is_showing_hidden_files

• String window_title

Default	"Save a File"
setter	set_title(value)
getter	get_title

方法说明

• add_filter add_filter(filter: String)

添加过滤器作为自定义过滤器; filter的形式应该是"filename.extension ; Description"。例如,"*.png ; PNG Images"。

---

• clear_filters clear_filters()

清除对话框中所有添加的过滤器。

---

• deselect_items deselect_items()

清除对话框中当前选择的项目。

---

• get_line_edit get_line_edit()

返回所选文件的LineEdit。

---

• get_vbox get_vbox()

返回对话框的垂直框容器，可以向其中添加自定义控件。

---

• invalidate invalidate()

无效并更新当前对话框内容列表。

---