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.

EditorFileDialog

继承: FileDialog < ConfirmationDialog < AcceptDialog < Window < Viewport < Node < Object

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

描述

EditorFileDialog 是一个专门针对编辑器工作流进行了微调优化的 FileDialog(文件对话框)。它会自动处理‘收藏夹’和‘最近访问’的目录列表,并且会将部分属性与对应的编辑器设置保持同步。

EditorFileDialog 会根据编辑器设置中的 EditorSettings.interface/editor/appearance/use_native_file_dialogs 自动决定是否显示系统原生的对话框,并且会直接忽略 FileDialog.use_native_dialog 的设置。

注意: EditorFileDialog 默认是隐藏的。如果想要让它显示出来,你需要在该节点上调用 Window 类中的某个 popup_* 方法,比如 Window.popup_centered_clamped()

注意: 在 Linux 和 macOS 系统上,处于沙盒模式(sandboxed)的应用程序总是会使用系统原生对话框来访问宿主机的文件系统。

属性

bool

disable_overwrite_warning

false

方法

void

add_side_menu(menu: Control, title: String = "")


属性说明

bool disable_overwrite_warning = false 🔗

  • void set_disable_overwrite_warning(value: bool)

  • bool is_overwrite_warning_disabled()

已弃用: Use FileDialog.overwrite_warning_enabled instead.

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


方法说明

void add_side_menu(menu: Control, title: String = "") 🔗

已弃用: This feature is no longer supported.

该方法仅为保持兼容性而保留,不执行任何操作。作为替代方案,你可以在显示文件对话框后显示另一个对话框。