EditorFileDialog

EditorFileDialog

继承： ConfirmationDialog < AcceptDialog < Window < Viewport < Node < Object

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

描述

EditorFileDialog 是 FileDialog 的增强版，只对编辑器插件可用。额外的功能包括收藏列表、最近文件列表和以缩略图网格而不是列表的形式查看文件的能力。

属性

Access	access	`0`
String	current_dir
String	current_file
String	current_path
bool	dialog_hide_on_ok	`false` (overrides AcceptDialog)
bool	disable_overwrite_warning	`false`
DisplayMode	display_mode	`0`
FileMode	file_mode	`4`
PackedStringArray	filters	`PackedStringArray()`
bool	show_hidden_files	`false`
String	title	`“Save a File”` (overrides Window)

方法

void	add_filter ( String filter, String description=”” )
void	add_side_menu ( Control menu, String title=”” )
void	clear_filters ( )
LineEdit	get_line_edit ( )
VBoxContainer	get_vbox ( )
void	invalidate ( )

信号

dir_selected ( String dir )

选择目录时触发。

file_selected ( String path )

选择文件时触发。

files_selected ( PackedStringArray paths )

选择多个文件时触发。

枚举

enum FileMode:

FileMode FILE_MODE_OPEN_FILE = 0

EditorFileDialog 仅可以选择一个文件，选择同意窗口将会打开这个文件。

FileMode FILE_MODE_OPEN_FILES = 1

EditorFileDialog 可以选择多个文件，选择同意窗口将会打开所有选择的文件。

FileMode FILE_MODE_OPEN_DIR = 2

EditorFileDialog 可以选择一个目录，选择同意窗口将会打开这个目录。

FileMode FILE_MODE_OPEN_ANY = 3

EditorFileDialog 可以选择一个文件或者目录，选择同意窗口将会打开这个文件或目录。

FileMode FILE_MODE_SAVE_FILE = 4

EditorFileDialog 可以选择一个文件，选择同意窗口将会保存这个文件。

enum Access:

Access ACCESS_RESOURCES = 0

EditorFileDialog 只能查看 res:// 目录里的内容。

Access ACCESS_USERDATA = 1

EditorFileDialog 只能查看user:// 目录里的内容。

Access ACCESS_FILESYSTEM = 2

EditorFileDialog 可以查看整个本地文件系统。

enum DisplayMode:

DisplayMode DISPLAY_THUMBNAILS = 0

EditorFileDialog 以图标的形式显示资源。

DisplayMode DISPLAY_LIST = 1

EditorFileDialog 以文件名列表的形式显示资源。

属性说明

Access access = 0

void set_access ( Access value )
Access get_access ( )

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

String current_dir

void set_current_dir ( String value )
String get_current_dir ( )

当前占用的目录。

String current_file

void set_current_file ( String value )
String get_current_file ( )

当前选择的文件。

String current_path

void set_current_path ( String value )
String get_current_path ( )

地址栏中的文件系统路径。

bool disable_overwrite_warning = false

void set_disable_overwrite_warning ( bool value )
bool is_overwrite_warning_disabled ( )

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

DisplayMode display_mode = 0

void set_display_mode ( DisplayMode value )
DisplayMode get_display_mode ( )

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

FileMode file_mode = 4

void set_file_mode ( FileMode value )
FileMode get_file_mode ( )

对话框的打开或保存模式，会影响选择行为。见 FileMode。

PackedStringArray filters = PackedStringArray()

void set_filters ( PackedStringArray value )
PackedStringArray get_filters ( )

可用的文件类型过滤器。例如，这样就只会显示 .png 和 .gd 文件：set_filters(PackedStringArray(["*.png ; PNG Images","*.gd ; GDScript Files"]))。也可以在单个过滤器中指定多种文件类型。选中 "*.png, *.jpg, *.jpeg ; 支持的图片" 时，将同时显示 PNG 和 JPEG 文件。

bool show_hidden_files = false