EditorFileDialog

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

Category: Core

Brief Description

Member Functions

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

Signals

Emitted when a directory is selected.

  • file_selected ( String path )

Emitted when a file is selected.

Emitted when multiple files are selected.

Member Variables

  • Access access - The location from which the user may select a file, including res://, user://, and the local file system.
  • String current_dir - The currently occupied directory.
  • String current_file - The currently selected file.
  • String current_path - The file system path in the address bar.
  • bool disable_overwrite_warning - If true the EditorFileDialog will not warn the user before overwriting files.
  • DisplayMode display_mode - The view format in which the EditorFileDialog displays resources to the user.
  • Mode mode - The purpose of the EditorFileDialog. Changes allowed behaviors.
  • bool show_hidden_files - If true hidden files and directories will be visible in the EditorFileDialog.

Enums

enum Access

  • ACCESS_RESOURCES = 0 — The EditorFileDialog can only view res:// directory contents.
  • ACCESS_USERDATA = 1 — The EditorFileDialog can only view user:// directory contents.
  • ACCESS_FILESYSTEM = 2 — The EditorFileDialog can view the entire local file system.

enum DisplayMode

  • DISPLAY_THUMBNAILS = 0 — The EditorFileDialog displays resources as thumbnails.
  • DISPLAY_LIST = 1 — The EditorFileDialog displays resources as a list of filenames.

enum Mode

  • MODE_OPEN_FILE = 0 — The EditorFileDialog can select only one file. Accepting the window will open the file.
  • MODE_OPEN_FILES = 1 — The EditorFileDialog can select multiple files. Accepting the window will open all files.
  • MODE_OPEN_DIR = 2 — The EditorFileDialog can select only one directory. Accepting the window will open the directory.
  • MODE_OPEN_ANY = 3 — The EditorFileDialog can select a file or directory. Accepting the window will open it.
  • MODE_SAVE_FILE = 4 — The EditorFileDialog can select only one file. Accepting the window will save the file.

Member Function Description

  • void add_filter ( String filter )

Adds a comma-delimited file extension filter option to the EditorFileDialog with an optional semi-colon-delimited label.

Example: “*.tscn, *.scn; Scenes”, results in filter text “Scenes (*.tscn, *.scn)”.

  • void clear_filters ( )

Removes all filters except for “All Files (*)”.

Returns the VBoxContainer used to display the file system.

  • void invalidate ( )

Notify the EditorFileDialog that its view of the data is no longer accurate. Updates the view contents on next view update.