FileDialog¶

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

Diálogo para seleccionar archivos o directorios en el sistema de archivos.

Descripción¶

FileDialog is a preset dialog used to choose files and directories in the filesystem. It supports filter masks. The FileDialog automatically sets its window title according to the mode. If you want to use a custom title, disable this by setting mode_overrides_title to false.

Propiedades¶

Access	access	`0`
String	current_dir	`"res://"`
String	current_file	`""`
String	current_path	`"res://"`
bool	dialog_hide_on_ok	`false` (overrides AcceptDialog)
PoolStringArray	filters	`PoolStringArray( )`
Mode	mode	`4`
bool	mode_overrides_title	`true`
bool	show_hidden_files	`false`
String	window_title	`"Save a File"` (overrides WindowDialog)

Métodos¶

void	add_filter ( String filter )
void	clear_filters ( )
void	deselect_items ( )
LineEdit	get_line_edit ( )
VBoxContainer	get_vbox ( )
void	invalidate ( )

Propiedades del Theme¶

Color	file_icon_modulate	`Color( 1, 1, 1, 1 )`
Color	files_disabled	`Color( 0, 0, 0, 0.7 )`
Color	folder_icon_modulate	`Color( 1, 1, 1, 1 )`
Texture	file
Texture	folder
Texture	parent_folder
Texture	reload
Texture	toggle_hidden

Señales¶

dir_selected ( String dir )

Emitido cuando el usuario selecciona un directorio.

file_selected ( String path )

Se emite cuando el usuario selecciona un archivo haciendo doble clic en él o pulsando el botón OK.

files_selected ( PoolStringArray paths )

Emitido cuando el usuario selecciona varios archivos.

Enumeraciones¶

enum Mode:

MODE_OPEN_FILE = 0 --- El diálogo permite seleccionar uno, y sólo un archivo.
MODE_OPEN_FILES = 1 --- El diálogo permite seleccionar varios archivos.
MODE_OPEN_DIR = 2 --- El diálogo sólo permite seleccionar un directorio, no permitiendo la selección de ningún archivo.
MODE_OPEN_ANY = 3 --- El diálogo permite seleccionar un archivo o directorio.
MODE_SAVE_FILE = 4 --- El diálogo avisará cuando exista un archivo.

enum Access:

ACCESS_RESOURCES = 0 --- El diálogo sólo permite acceder a los archivos bajo la ruta Resource (res://).
ACCESS_USERDATA = 1 --- El diálogo sólo permite acceder a los archivos bajo la ruta de datos del usuario (user://).
ACCESS_FILESYSTEM = 2 --- El diálogo permite acceder a los archivos de todo el sistema de archivos.

Descripciones de Propiedades¶

Access access

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

The file system access scope. See enum Access constants.

Warning: Currently, in sandboxed environments such as HTML5 builds or sandboxed macOS apps, FileDialog cannot access the host file system. See godot-proposals#1123.

String current_dir

Default	`"res://"`
Setter	set_current_dir(value)
Getter	get_current_dir()

El directorio de trabajo actual del diálogo de archivos.

String current_file

Default	`""`
Setter	set_current_file(value)
Getter	get_current_file()

El archivo actualmente seleccionado del diálogo de archivos.

String current_path

Default	`"res://"`
Setter	set_current_path(value)
Getter	get_current_path()

La ruta de archivo actualmente seleccionada del diálogo de archivo.

PoolStringArray filters

Default	`PoolStringArray( )`
Setter	set_filters(value)
Getter	get_filters()

The available file type filters. For example, this shows only .png and .gd files: set_filters(PoolStringArray(["*.png ; PNG Images","*.gd ; GDScript Files"])).

Mode mode

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

The dialog's open or save mode, which affects the selection behavior. See enum Mode constants.

bool mode_overrides_title

Default	`true`
Setter	set_mode_overrides_title(value)
Getter	is_mode_overriding_title()

If true, changing the Mode property will set the window title accordingly (e.g. setting mode to MODE_OPEN_FILE will change the window title to "Open a File").

bool show_hidden_files

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

Si true, el diálogo mostrará los archivos ocultos.

Descripciones de Métodos¶

void add_filter ( String filter )

Añade filter como filtro personalizado; filter debe tener la forma "filename.extension ; Description". Por ejemplo, "*.png ; Imágenes PNG".

void clear_filters ( )

Borra todos los filtros añadidos en el diálogo.

void deselect_items ( )

Borra los elementos actualmente seleccionados en el diálogo.

LineEdit get_line_edit ( )

Returns the LineEdit for the selected file.

Warning: This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their CanvasItem.visible property.

VBoxContainer get_vbox ( )

Returns the vertical box container of the dialog, custom controls can be added to it.

Warning: This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their CanvasItem.visible property.

void invalidate ( )

Invalida y actualiza la lista de contenido del diálogo actual.

Theme Property Descriptions¶

Color file_icon_modulate

Default

Color( 1, 1, 1, 1 )

La modulación del color aplicada al icono del archivo.

Color files_disabled

Default

Color( 0, 0, 0, 0.7 )

El tinte de color para los archivos desactivados (cuando se utiliza FileDialog en el modo de carpeta abierta).

Color folder_icon_modulate

Default

Color( 1, 1, 1, 1 )

La modulación del color aplicada al icono de la carpeta.

Texture file

Icono personalizado para los archivos.

Texture folder

Icono personalizado para las carpetas.

Texture parent_folder

Icono personalizado para la flecha de la carpeta principal.

Texture reload

Icono personalizado para el botón de recarga.

Texture toggle_hidden

Icono personalizado para el botón oculto de commutación.