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¶
|
||
|
||
|
||
|
||
dialog_hide_on_ok |
|
|
|
||
|
||
|
||
|
||
window_title |
|
Métodos¶
void |
add_filter ( String filter ) |
void |
clear_filters ( ) |
void |
deselect_items ( ) |
get_line_edit ( ) |
|
get_vbox ( ) |
|
void |
invalidate ( ) |
Propiedades del Theme¶
|
||
|
||
|
||
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 |
|
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 |
|
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 |
|
Setter |
set_current_path(value) |
Getter |
get_current_path() |
La ruta de archivo actualmente seleccionada del diálogo de archivo.
PoolStringArray filters
Default |
|
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 |
|
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 |
|
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").
Default |
|
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 |
|
La modulación del color aplicada al icono del archivo.
Color files_disabled
Default |
|
El tinte de color para los archivos desactivados (cuando se utiliza FileDialog
en el modo de carpeta abierta).
Color folder_icon_modulate
Default |
|
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.
Icono personalizado para el botón oculto de commutación.