Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

EditorFileDialog

Inherits: ConfirmationDialog < AcceptDialog < Window < Viewport < Node < Object

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

Description

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

Properties

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)

Methods

void

add_filter ( String filter, String description="" )

void

clear_filters ( )

LineEdit

get_line_edit ( )

VBoxContainer

get_vbox ( )

void

invalidate ( )

Signals

dir_selected ( String dir )

选择目录时触发。

file_selected ( String path )

选择文件时触发。

files_selected ( PackedStringArray paths )

选择多个文件时触发。

Enumerations

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 以文件名列表的形式显示资源。

Property Descriptions

Access access = 0

用户可以选择文件的位置，包括 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

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

FileMode file_mode = 4

  • void set_file_mode (