EditorFileDialog

EditorFileDialog

Inherits: ConfirmationDialog < AcceptDialog < WindowDialog < Popup < Control < CanvasItem < Node < Object

编辑器使用的FileDialog的修改版。

属性

Access	access	`0`
String	current_dir	`“res://“`
String	current_file	`“”`
String	current_path	`“res://“`
bool	dialog_hide_on_ok	`false` (overrides AcceptDialog)
bool	disable_overwrite_warning	`false`
DisplayMode	display_mode	`0`
Mode	mode	`4`
bool	resizable	`true` (overrides WindowDialog)
bool	show_hidden_files	`false`
String	window_title	`“Save a File”` (overrides WindowDialog)

方法

void	add_filter ( String filter )
void	clear_filters ( )
VBoxContainer	get_vbox ( )
void	invalidate ( )

信号

dir_selected ( String dir )

选择目录时触发。

file_selected ( String path )

选择文件时触发。

files_selected ( PoolStringArray paths )

选择多个文件时触发。

枚举

enum Mode:

MODE_OPEN_FILE = 0 —- EditorFileDialog 仅可以选择一个文件，选择同意窗口将会打开这个文件。
MODE_OPEN_FILES = 1 —- EditorFileDialog 可以选择多个文件，选择同意窗口将会打开所有选择的文件。
MODE_OPEN_DIR = 2 —- EditorFileDialog 可以选择一个目录，选择同意窗口将会打开这个目录。
MODE_OPEN_ANY = 3 —- EditorFileDialog 可以选择一个文件或者目录，选择同意窗口将会打开这个文件或目录。
MODE_SAVE_FILE = 4 —- EditorFileDialog 可以选择一个文件，选择同意窗口将会保存这个文件。

enum Access:

ACCESS_RESOURCES = 0 —- EditorFileDialog 只能查看 res:// 目录里的内容。
ACCESS_USERDATA = 1 —- EditorFileDialog 只能查看user:// 目录里的内容。
ACCESS_FILESYSTEM = 2 —- EditorFileDialog 可以查看整个本地文件系统。

enum DisplayMode:

DISPLAY_THUMBNAILS = 0 —- EditorFileDialog 以图标的形式显示资源。
DISPLAY_LIST = 1 —- EditorFileDialog 以文件名列表的形式显示资源。

属性说明

Access access

Default	`0`
Setter	set_access(value)
Getter	get_access()

用户可以选择文件的位置，包括res://、user://和本地文件系统。

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 disable_overwrite_warning

Default	`false`
Setter	set_disable_overwrite_warning(value)
Getter	is_overwrite_warning_disabled()

如果true，EditorFileDialog将不会在覆盖文件之前警告用户。

DisplayMode display_mode

Default	`0`
Setter	set_display_mode(value)
Getter	get_display_mode()

EditorFileDialog向用户显示资源的视图格式。

Mode mode

Default	`4`
Setter	set_mode(value)
Getter	get_mode()

EditorFileDialog 的用途，它定义了允许的行为。

bool show_hidden_files

Default	`false`
Setter	set_show_hidden_files(value)
Getter	is_showing_hidden_files()

如果true，隐藏的文件和目录将在EditorFileDialog中可见。

方法说明

void add_filter ( String filter )

在 EditorFileDialog 中添加一个以逗号分隔的文件扩展名过滤选项，可选择以分号分隔的标签。

例如，"*.tscn, *.scn; Scenes" 的结果是过滤器文本 “Scenes (*.tscn, *.scn)”。

void clear_filters ( )

删除除“All Files(*)”筛选器之外的所有筛选器。

VBoxContainer get_vbox ( )

返回用于显示文件系统的VBoxContainer。

警告： 这是一个必需的内部节点，移除和释放它可能会导致崩溃。如果你想隐藏它或它的任何子节点，请使用 CanvasItem.visible 属性。

void invalidate ( )

通知EditorFileDialog它的数据视图不再准确。在下次视图更新时更新视图内容。