Files
godot-docs-l10n/classes/it/class_filedialog.rst
2025-12-19 14:34:07 +01:00

1275 lines
65 KiB
ReStructuredText

:github_url: hide
.. _class_FileDialog:
FileDialog
==========
**Eredita:** :ref:`ConfirmationDialog<class_ConfirmationDialog>` **<** :ref:`AcceptDialog<class_AcceptDialog>` **<** :ref:`Window<class_Window>` **<** :ref:`Viewport<class_Viewport>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
Una finestra di dialogo per selezionare file o cartelle nel file system.
.. rst-class:: classref-introduction-group
Descrizione
----------------------
**FileDialog** è una finestra di dialogo preimpostata utilizzata per scegliere file e cartelle nel file system. Supporta maschere di filtro. **FileDialog** imposta automaticamente il titolo della sua finestra in base a :ref:`file_mode<class_FileDialog_property_file_mode>`. Se si desidera usare un titolo personalizzato, disattivalo impostando :ref:`mode_overrides_title<class_FileDialog_property_mode_overrides_title>` su ``false``.
.. rst-class:: classref-reftable-group
Proprietà
------------------
.. table::
:widths: auto
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`Access<enum_FileDialog_Access>` | :ref:`access<class_FileDialog_property_access>` | ``0`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`current_dir<class_FileDialog_property_current_dir>` | |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`current_file<class_FileDialog_property_current_file>` | |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`current_path<class_FileDialog_property_current_path>` | |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | dialog_hide_on_ok | ``false`` (overrides :ref:`AcceptDialog<class_AcceptDialog_property_dialog_hide_on_ok>`) |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`DisplayMode<enum_FileDialog_DisplayMode>` | :ref:`display_mode<class_FileDialog_property_display_mode>` | ``0`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`favorites_enabled<class_FileDialog_property_favorites_enabled>` | ``true`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`file_filter_toggle_enabled<class_FileDialog_property_file_filter_toggle_enabled>` | ``true`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`FileMode<enum_FileDialog_FileMode>` | :ref:`file_mode<class_FileDialog_property_file_mode>` | ``4`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`file_sort_options_enabled<class_FileDialog_property_file_sort_options_enabled>` | ``true`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`filename_filter<class_FileDialog_property_filename_filter>` | ``""`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`filters<class_FileDialog_property_filters>` | ``PackedStringArray()`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`folder_creation_enabled<class_FileDialog_property_folder_creation_enabled>` | ``true`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`hidden_files_toggle_enabled<class_FileDialog_property_hidden_files_toggle_enabled>` | ``true`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`layout_toggle_enabled<class_FileDialog_property_layout_toggle_enabled>` | ``true`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`mode_overrides_title<class_FileDialog_property_mode_overrides_title>` | ``true`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`option_count<class_FileDialog_property_option_count>` | ``0`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`recent_list_enabled<class_FileDialog_property_recent_list_enabled>` | ``true`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`root_subfolder<class_FileDialog_property_root_subfolder>` | ``""`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`show_hidden_files<class_FileDialog_property_show_hidden_files>` | ``false`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`Vector2i<class_Vector2i>` | size | ``Vector2i(640, 360)`` (overrides :ref:`Window<class_Window_property_size>`) |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | title | ``"Save a File"`` (overrides :ref:`Window<class_Window_property_title>`) |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`use_native_dialog<class_FileDialog_property_use_native_dialog>` | ``false`` |
+---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Metodi
------------
.. table::
:widths: auto
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_filter<class_FileDialog_method_add_filter>`\ (\ filter\: :ref:`String<class_String>`, description\: :ref:`String<class_String>` = ""\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_option<class_FileDialog_method_add_option>`\ (\ name\: :ref:`String<class_String>`, values\: :ref:`PackedStringArray<class_PackedStringArray>`, default_value_index\: :ref:`int<class_int>`\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`clear_filename_filter<class_FileDialog_method_clear_filename_filter>`\ (\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`clear_filters<class_FileDialog_method_clear_filters>`\ (\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`deselect_all<class_FileDialog_method_deselect_all>`\ (\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`LineEdit<class_LineEdit>` | :ref:`get_line_edit<class_FileDialog_method_get_line_edit>`\ (\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_option_default<class_FileDialog_method_get_option_default>`\ (\ option\: :ref:`int<class_int>`\ ) |const| |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_option_name<class_FileDialog_method_get_option_name>`\ (\ option\: :ref:`int<class_int>`\ ) |const| |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`get_option_values<class_FileDialog_method_get_option_values>`\ (\ option\: :ref:`int<class_int>`\ ) |const| |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_selected_options<class_FileDialog_method_get_selected_options>`\ (\ ) |const| |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`VBoxContainer<class_VBoxContainer>` | :ref:`get_vbox<class_FileDialog_method_get_vbox>`\ (\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`invalidate<class_FileDialog_method_invalidate>`\ (\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_customization_flag_enabled<class_FileDialog_method_is_customization_flag_enabled>`\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const| |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_customization_flag_enabled<class_FileDialog_method_set_customization_flag_enabled>`\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_option_default<class_FileDialog_method_set_option_default>`\ (\ option\: :ref:`int<class_int>`, default_value_index\: :ref:`int<class_int>`\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_option_name<class_FileDialog_method_set_option_name>`\ (\ option\: :ref:`int<class_int>`, name\: :ref:`String<class_String>`\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_option_values<class_FileDialog_method_set_option_values>`\ (\ option\: :ref:`int<class_int>`, values\: :ref:`PackedStringArray<class_PackedStringArray>`\ ) |
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Proprietà del tema
------------------------------------
.. table::
:widths: auto
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Color<class_Color>` | :ref:`file_disabled_color<class_FileDialog_theme_color_file_disabled_color>` | ``Color(1, 1, 1, 0.25)`` |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Color<class_Color>` | :ref:`file_icon_color<class_FileDialog_theme_color_file_icon_color>` | ``Color(1, 1, 1, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Color<class_Color>` | :ref:`folder_icon_color<class_FileDialog_theme_color_folder_icon_color>` | ``Color(1, 1, 1, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`int<class_int>` | :ref:`thumbnail_size<class_FileDialog_theme_constant_thumbnail_size>` | ``64`` |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`back_folder<class_FileDialog_theme_icon_back_folder>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`create_folder<class_FileDialog_theme_icon_create_folder>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`favorite<class_FileDialog_theme_icon_favorite>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`favorite_down<class_FileDialog_theme_icon_favorite_down>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`favorite_up<class_FileDialog_theme_icon_favorite_up>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`file<class_FileDialog_theme_icon_file>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`file_thumbnail<class_FileDialog_theme_icon_file_thumbnail>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`folder<class_FileDialog_theme_icon_folder>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`folder_thumbnail<class_FileDialog_theme_icon_folder_thumbnail>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`forward_folder<class_FileDialog_theme_icon_forward_folder>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`list_mode<class_FileDialog_theme_icon_list_mode>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`parent_folder<class_FileDialog_theme_icon_parent_folder>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`reload<class_FileDialog_theme_icon_reload>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`sort<class_FileDialog_theme_icon_sort>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`thumbnail_mode<class_FileDialog_theme_icon_thumbnail_mode>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`toggle_filename_filter<class_FileDialog_theme_icon_toggle_filename_filter>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`toggle_hidden<class_FileDialog_theme_icon_toggle_hidden>` | |
+-----------------------------------+-----------------------------------------------------------------------------------+--------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Segnali
--------------
.. _class_FileDialog_signal_dir_selected:
.. rst-class:: classref-signal
**dir_selected**\ (\ dir\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileDialog_signal_dir_selected>`
Emesso quando l'utente seleziona una cartella.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_signal_file_selected:
.. rst-class:: classref-signal
**file_selected**\ (\ path\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileDialog_signal_file_selected>`
Emesso quando l'utente seleziona un file cliccando due volte su di esso o premendo il pulsante **OK**.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_signal_filename_filter_changed:
.. rst-class:: classref-signal
**filename_filter_changed**\ (\ filter\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileDialog_signal_filename_filter_changed>`
Emesso quando il filtro per i nomi dei file cambia.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_signal_files_selected:
.. rst-class:: classref-signal
**files_selected**\ (\ paths\: :ref:`PackedStringArray<class_PackedStringArray>`\ ) :ref:`🔗<class_FileDialog_signal_files_selected>`
Emesso quando l'utente seleziona più file.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Enumerazioni
------------------------
.. _enum_FileDialog_FileMode:
.. rst-class:: classref-enumeration
enum **FileMode**: :ref:`🔗<enum_FileDialog_FileMode>`
.. _class_FileDialog_constant_FILE_MODE_OPEN_FILE:
.. rst-class:: classref-enumeration-constant
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_OPEN_FILE** = ``0``
La finestra di dialogo consente di selezionare solamente un file.
.. _class_FileDialog_constant_FILE_MODE_OPEN_FILES:
.. rst-class:: classref-enumeration-constant
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_OPEN_FILES** = ``1``
La finestra di dialogo consente di selezionare più file.
.. _class_FileDialog_constant_FILE_MODE_OPEN_DIR:
.. rst-class:: classref-enumeration-constant
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_OPEN_DIR** = ``2``
La finestra di dialogo consente solo la selezione di una cartella, non consentendo la selezione di alcun file.
.. _class_FileDialog_constant_FILE_MODE_OPEN_ANY:
.. rst-class:: classref-enumeration-constant
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_OPEN_ANY** = ``3``
La finestra di dialogo nativa dei file consente di selezionare un file o una cartella.
.. _class_FileDialog_constant_FILE_MODE_SAVE_FILE:
.. rst-class:: classref-enumeration-constant
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_SAVE_FILE** = ``4``
La finestra di dialogo avviserà quando esiste un file.
.. rst-class:: classref-item-separator
----
.. _enum_FileDialog_Access:
.. rst-class:: classref-enumeration
enum **Access**: :ref:`🔗<enum_FileDialog_Access>`
.. _class_FileDialog_constant_ACCESS_RESOURCES:
.. rst-class:: classref-enumeration-constant
:ref:`Access<enum_FileDialog_Access>` **ACCESS_RESOURCES** = ``0``
La finestra di dialogo consente l'accesso solo ai file nel percorso per i :ref:`Resource<class_Resource>` (``res://``).
.. _class_FileDialog_constant_ACCESS_USERDATA:
.. rst-class:: classref-enumeration-constant
:ref:`Access<enum_FileDialog_Access>` **ACCESS_USERDATA** = ``1``
La finestra di dialogo consente l'accesso solo ai file nel percorso dei dati utente (``user://``).
.. _class_FileDialog_constant_ACCESS_FILESYSTEM:
.. rst-class:: classref-enumeration-constant
:ref:`Access<enum_FileDialog_Access>` **ACCESS_FILESYSTEM** = ``2``
La finestra di dialogo consente di accedere ai file dell'intero file system.
.. rst-class:: classref-item-separator
----
.. _enum_FileDialog_DisplayMode:
.. rst-class:: classref-enumeration
enum **DisplayMode**: :ref:`🔗<enum_FileDialog_DisplayMode>`
.. _class_FileDialog_constant_DISPLAY_THUMBNAILS:
.. rst-class:: classref-enumeration-constant
:ref:`DisplayMode<enum_FileDialog_DisplayMode>` **DISPLAY_THUMBNAILS** = ``0``
La finestra di dialogo visualizza i file come una griglia di miniature. Usa :ref:`thumbnail_size<class_FileDialog_theme_constant_thumbnail_size>` per regolarne le dimensioni.
.. _class_FileDialog_constant_DISPLAY_LIST:
.. rst-class:: classref-enumeration-constant
:ref:`DisplayMode<enum_FileDialog_DisplayMode>` **DISPLAY_LIST** = ``1``
La finestra di dialogo visualizza i file come un elenco di nomi di file.
.. rst-class:: classref-item-separator
----
.. _enum_FileDialog_Customization:
.. rst-class:: classref-enumeration
enum **Customization**: :ref:`🔗<enum_FileDialog_Customization>`
.. _class_FileDialog_constant_CUSTOMIZATION_HIDDEN_FILES:
.. rst-class:: classref-enumeration-constant
:ref:`Customization<enum_FileDialog_Customization>` **CUSTOMIZATION_HIDDEN_FILES** = ``0``
Cambia la visibilità del pulsante per aggiungere ai preferiti, e dell'elenco dei preferiti sul lato sinistro della finestra di dialogo.
Equivale a :ref:`favorites_enabled<class_FileDialog_property_favorites_enabled>`.
.. _class_FileDialog_constant_CUSTOMIZATION_CREATE_FOLDER:
.. rst-class:: classref-enumeration-constant
:ref:`Customization<enum_FileDialog_Customization>` **CUSTOMIZATION_CREATE_FOLDER** = ``1``
Se abilitato, mostra il pulsante per la creazione di nuove cartella (quando si utilizza :ref:`FILE_MODE_OPEN_DIR<class_FileDialog_constant_FILE_MODE_OPEN_DIR>`, :ref:`FILE_MODE_OPEN_ANY<class_FileDialog_constant_FILE_MODE_OPEN_ANY>` o :ref:`FILE_MODE_SAVE_FILE<class_FileDialog_constant_FILE_MODE_SAVE_FILE>`).
Equivale a :ref:`folder_creation_enabled<class_FileDialog_property_folder_creation_enabled>`.
.. _class_FileDialog_constant_CUSTOMIZATION_FILE_FILTER:
.. rst-class:: classref-enumeration-constant
:ref:`Customization<enum_FileDialog_Customization>` **CUSTOMIZATION_FILE_FILTER** = ``2``
Se abilitato, mostra il pulsante per attivare/disattivare il filtro file.
Equivale a :ref:`file_filter_toggle_enabled<class_FileDialog_property_file_filter_toggle_enabled>`.
.. _class_FileDialog_constant_CUSTOMIZATION_FILE_SORT:
.. rst-class:: classref-enumeration-constant
:ref:`Customization<enum_FileDialog_Customization>` **CUSTOMIZATION_FILE_SORT** = ``3``
Se abilitato, mostra il pulsante per le opzioni di ordinamento dei file.
Equivale a :ref:`file_sort_options_enabled<class_FileDialog_property_file_sort_options_enabled>`.
.. _class_FileDialog_constant_CUSTOMIZATION_FAVORITES:
.. rst-class:: classref-enumeration-constant
:ref:`Customization<enum_FileDialog_Customization>` **CUSTOMIZATION_FAVORITES** = ``4``
Se abilitato, mostra il pulsante per aggiungere ai preferiti e l'elenco dei preferiti sul lato sinistro della finestra di dialogo.
Equivale a :ref:`favorites_enabled<class_FileDialog_property_favorites_enabled>`.
.. _class_FileDialog_constant_CUSTOMIZATION_RECENT:
.. rst-class:: classref-enumeration-constant
:ref:`Customization<enum_FileDialog_Customization>` **CUSTOMIZATION_RECENT** = ``5``
Se abilitato, mostra l'elenco delle cartelle recenti sul lato sinistro della finestra di dialogo.
Equivale a :ref:`recent_list_enabled<class_FileDialog_property_recent_list_enabled>`.
.. _class_FileDialog_constant_CUSTOMIZATION_LAYOUT:
.. rst-class:: classref-enumeration-constant
:ref:`Customization<enum_FileDialog_Customization>` **CUSTOMIZATION_LAYOUT** = ``6``
Se abilitato, mostra i pulsanti per cambiare layout (elenco/miniature).
Equivale a :ref:`layout_toggle_enabled<class_FileDialog_property_layout_toggle_enabled>`.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà
------------------------------------------------------
.. _class_FileDialog_property_access:
.. rst-class:: classref-property
:ref:`Access<enum_FileDialog_Access>` **access** = ``0`` :ref:`🔗<class_FileDialog_property_access>`
.. rst-class:: classref-property-setget
- |void| **set_access**\ (\ value\: :ref:`Access<enum_FileDialog_Access>`\ )
- :ref:`Access<enum_FileDialog_Access>` **get_access**\ (\ )
L'ambito di accesso al file system.
\ **Attenzione:** Nelle build Web, FileDialog non può accedere al file system dell'host. Negli ambienti Linux e macOS in sandbox, :ref:`use_native_dialog<class_FileDialog_property_use_native_dialog>` è utilizzato automaticamente per consentire un accesso limitato al file system dell'host.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_current_dir:
.. rst-class:: classref-property
:ref:`String<class_String>` **current_dir** :ref:`🔗<class_FileDialog_property_current_dir>`
.. rst-class:: classref-property-setget
- |void| **set_current_dir**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_current_dir**\ (\ )
La cartella di lavoro attuale della finestra di dialogo dei file.
\ **Nota:** Per le finestre di dialogo dei file native, questa proprietà viene trattata solo come un suggerimento e potrebbe non essere rispettata da alcune implementazioni del sistema operativo.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_current_file:
.. rst-class:: classref-property
:ref:`String<class_String>` **current_file** :ref:`🔗<class_FileDialog_property_current_file>`
.. rst-class:: classref-property-setget
- |void| **set_current_file**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_current_file**\ (\ )
Il file attualmente selezionato nella finestra di dialogo dei file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_current_path:
.. rst-class:: classref-property
:ref:`String<class_String>` **current_path** :ref:`🔗<class_FileDialog_property_current_path>`
.. rst-class:: classref-property-setget
- |void| **set_current_path**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_current_path**\ (\ )
Il percorso di file attualmente selezionato nella finestra di dialogo dei file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_display_mode:
.. rst-class:: classref-property
:ref:`DisplayMode<enum_FileDialog_DisplayMode>` **display_mode** = ``0`` :ref:`🔗<class_FileDialog_property_display_mode>`
.. rst-class:: classref-property-setget
- |void| **set_display_mode**\ (\ value\: :ref:`DisplayMode<enum_FileDialog_DisplayMode>`\ )
- :ref:`DisplayMode<enum_FileDialog_DisplayMode>` **get_display_mode**\ (\ )
Modalità di visualizzazione dell'elenco dei file nella finestra di dialogo.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_favorites_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **favorites_enabled** = ``true`` :ref:`🔗<class_FileDialog_property_favorites_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const|
Se ``true``, mostra il pulsante per aggiungere ai preferiti, e dell'elenco dei preferiti sul lato sinistro della finestra di dialogo.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_file_filter_toggle_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **file_filter_toggle_enabled** = ``true`` :ref:`🔗<class_FileDialog_property_file_filter_toggle_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const|
Se ``true``, mostra il pulsante per attivare/disattivare il filtro file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_file_mode:
.. rst-class:: classref-property
:ref:`FileMode<enum_FileDialog_FileMode>` **file_mode** = ``4`` :ref:`🔗<class_FileDialog_property_file_mode>`
.. rst-class:: classref-property-setget
- |void| **set_file_mode**\ (\ value\: :ref:`FileMode<enum_FileDialog_FileMode>`\ )
- :ref:`FileMode<enum_FileDialog_FileMode>` **get_file_mode**\ (\ )
La modalità di apertura o salvataggio della finestra di dialogo, che influenza il comportamento di selezione.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_file_sort_options_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **file_sort_options_enabled** = ``true`` :ref:`🔗<class_FileDialog_property_file_sort_options_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const|
Se ``true``, mostra il pulsante per le opzioni di ordinamento dei file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_filename_filter:
.. rst-class:: classref-property
:ref:`String<class_String>` **filename_filter** = ``""`` :ref:`🔗<class_FileDialog_property_filename_filter>`
.. rst-class:: classref-property-setget
- |void| **set_filename_filter**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_filename_filter**\ (\ )
Il filtro per i nomi dei file (non sensibile alle maiuscole/minuscole). Se impostato su una stringa non vuota, saranno mostrati solo i file che contengono la sottostringa. È possibile modificare :ref:`filename_filter<class_FileDialog_property_filename_filter>` dall'utente con il pulsante filtro in cima alla finestra di dialogo dei file.
Vedi anche :ref:`filters<class_FileDialog_property_filters>`, che si dovrebbe utilizzare per limitare i tipi di file selezionabili, invece di :ref:`filename_filter<class_FileDialog_property_filename_filter>` che dovrebbe essere impostato dall'utente.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_filters:
.. rst-class:: classref-property
:ref:`PackedStringArray<class_PackedStringArray>` **filters** = ``PackedStringArray()`` :ref:`🔗<class_FileDialog_property_filters>`
.. rst-class:: classref-property-setget
- |void| **set_filters**\ (\ value\: :ref:`PackedStringArray<class_PackedStringArray>`\ )
- :ref:`PackedStringArray<class_PackedStringArray>` **get_filters**\ (\ )
I filtri di tipo file disponibili. Ogni stringa di filtro nell'array dovrebbe essere formattata in questo modo: ``*.png,*.jpg,*.jpeg;Image Files;image/png,image/jpeg``. Il testo descrittivo del filtro è facoltativo e può essere omesso. Sia le estensioni file che il tipo MIME dovrebbero essere sempre impostati.
\ **Nota:** Sia le finestre di dialogo incorporate, sia le finestre di dialogo su Windows supportano solo le estensioni dei file, mentre su Android, Linux e macOS esse supportano anche i tipi MIME.
**Note:** The returned array is *copied* and any changes to it will not update the original property value. See :ref:`PackedStringArray<class_PackedStringArray>` for more details.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_folder_creation_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **folder_creation_enabled** = ``true`` :ref:`🔗<class_FileDialog_property_folder_creation_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const|
Se ``true``, mostra il pulsante per creare nuove cartelle (quando si utilizza :ref:`FILE_MODE_OPEN_DIR<class_FileDialog_constant_FILE_MODE_OPEN_DIR>`, :ref:`FILE_MODE_OPEN_ANY<class_FileDialog_constant_FILE_MODE_OPEN_ANY>` o :ref:`FILE_MODE_SAVE_FILE<class_FileDialog_constant_FILE_MODE_SAVE_FILE>`).
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_hidden_files_toggle_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **hidden_files_toggle_enabled** = ``true`` :ref:`🔗<class_FileDialog_property_hidden_files_toggle_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const|
Se ``true``, mostra il pulsante per cambiare la visibilità dei file nascosti.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_layout_toggle_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **layout_toggle_enabled** = ``true`` :ref:`🔗<class_FileDialog_property_layout_toggle_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const|
Se ``true``, mostra i pulsanti per cambiare layout (elenco/miniature).
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_mode_overrides_title:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **mode_overrides_title** = ``true`` :ref:`🔗<class_FileDialog_property_mode_overrides_title>`
.. rst-class:: classref-property-setget
- |void| **set_mode_overrides_title**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_mode_overriding_title**\ (\ )
Se ``true``, modificando la proprietà :ref:`file_mode<class_FileDialog_property_file_mode>` si imposterà di conseguenza il titolo della finestra (ad esempio, impostando :ref:`file_mode<class_FileDialog_property_file_mode>` su :ref:`FILE_MODE_OPEN_FILE<class_FileDialog_constant_FILE_MODE_OPEN_FILE>` il titolo della finestra cambierà in "Apri un file").
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_option_count:
.. rst-class:: classref-property
:ref:`int<class_int>` **option_count** = ``0`` :ref:`🔗<class_FileDialog_property_option_count>`
.. rst-class:: classref-property-setget
- |void| **set_option_count**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_option_count**\ (\ )
Numero di :ref:`OptionButton<class_OptionButton>` e :ref:`CheckBox<class_CheckBox>` aggiuntivi nella finestra di dialogo.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_recent_list_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **recent_list_enabled** = ``true`` :ref:`🔗<class_FileDialog_property_recent_list_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const|
Se ``true``, mostra l'elenco delle cartelle recenti sul lato sinistro della finestra di dialogo.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_root_subfolder:
.. rst-class:: classref-property
:ref:`String<class_String>` **root_subfolder** = ``""`` :ref:`🔗<class_FileDialog_property_root_subfolder>`
.. rst-class:: classref-property-setget
- |void| **set_root_subfolder**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_root_subfolder**\ (\ )
Se non è vuoto, la sottocartella specificata sarà la "radice" di questo **FileDialog**, ovvero l'utente non sarà in grado di andare alla sua cartella madre.
\ **Nota:** Questa proprietà è ignorata dalle finestre di dialogo native dei file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_show_hidden_files:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **show_hidden_files** = ``false`` :ref:`🔗<class_FileDialog_property_show_hidden_files>`
.. rst-class:: classref-property-setget
- |void| **set_show_hidden_files**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_showing_hidden_files**\ (\ )
Se ``true``, la finestra di dialogo mostrerà i file nascosti.
\ **Nota:** Questa proprietà è ignorata dalle finestre di dialogo native dei file su Android e Linux.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_property_use_native_dialog:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **use_native_dialog** = ``false`` :ref:`🔗<class_FileDialog_property_use_native_dialog>`
.. rst-class:: classref-property-setget
- |void| **set_use_native_dialog**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_use_native_dialog**\ (\ )
Se ``true``, e se supportato dal :ref:`DisplayServer<class_DisplayServer>` attuale, sarà utilizzata una finestra di dialogo nativa del sistema operativo anziché quella personalizzata.
\ **Nota:** Su Android, ciò è supportato solo sui dispositivi Android 10+ e se si utilizza :ref:`ACCESS_FILESYSTEM<class_FileDialog_constant_ACCESS_FILESYSTEM>`. Per le modalità di accesso :ref:`ACCESS_RESOURCES<class_FileDialog_constant_ACCESS_RESOURCES>` e :ref:`ACCESS_USERDATA<class_FileDialog_constant_ACCESS_USERDATA>`, il sistema ritornerà al FileDialog personalizzato.
\ **Nota:** Su Linux e macOS, le app in sandbox utilizzano sempre le finestre di dialogo native per accedere al file system dell'host.
\ **Nota:** Su macOS, le app in sandbox salveranno i segnalibri con ambito di sicurezza per mantenere l'accesso alle cartelle aperte in più sessioni. Usa :ref:`OS.get_granted_permissions()<class_OS_method_get_granted_permissions>` per ottenere una lista dei segnalibri salvati.
\ **Nota:** Le finestre di dialogo native sono isolate dal processo base, le proprietà della finestra di dialogo del file non si possono cambiare una volta che la finestra di dialogo viene mostrata.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni dei metodi
--------------------------------------------
.. _class_FileDialog_method_add_filter:
.. rst-class:: classref-method
|void| **add_filter**\ (\ filter\: :ref:`String<class_String>`, description\: :ref:`String<class_String>` = ""\ ) :ref:`🔗<class_FileDialog_method_add_filter>`
Aggiunge un'opzione di filtro (``filter``) delimitata da virgole per i nomi dei file a **FileDialog** con una descrizione (``description``) facoltativa, che limita i file che si possono selezionare.
\ ``filter`` dovrebbe essere del formato ``"filename.extension"``, dove filename ed extension possono essere ``*`` per corrispondere a qualsiasi stringa. I filtri che iniziano con ``.`` (ad esempio i nomi vuoti dei file) non sono consentiti.
Ad esempio, un ``filter`` di ``"*.png, *.jpg"`` e una ``description`` di ``"Immagini "`` generano il testo del filtro "Immagini (\*.png, \*.jpg)".
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_add_option:
.. rst-class:: classref-method
|void| **add_option**\ (\ name\: :ref:`String<class_String>`, values\: :ref:`PackedStringArray<class_PackedStringArray>`, default_value_index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_FileDialog_method_add_option>`
Aggiunge un :ref:`OptionButton<class_OptionButton>` aggiuntivo alla finestra di dialogo dei file. Se ``values`` è vuoto, viene aggiunto un :ref:`CheckBox<class_CheckBox>`.
\ ``default_value_index`` dovrebbe essere un indice del valore in ``values``. Se ``values`` è vuoto, dovrebbe essere ``1`` (selezionato) o ``0`` (non selezionato).
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_clear_filename_filter:
.. rst-class:: classref-method
|void| **clear_filename_filter**\ (\ ) :ref:`🔗<class_FileDialog_method_clear_filename_filter>`
Svuota il filtro per i nomi dei file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_clear_filters:
.. rst-class:: classref-method
|void| **clear_filters**\ (\ ) :ref:`🔗<class_FileDialog_method_clear_filters>`
Cancella tutti i filtri aggiunti nella finestra di dialogo.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_deselect_all:
.. rst-class:: classref-method
|void| **deselect_all**\ (\ ) :ref:`🔗<class_FileDialog_method_deselect_all>`
Cancella tutti gli elementi attualmente selezionati nella finestra di dialogo.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_get_line_edit:
.. rst-class:: classref-method
:ref:`LineEdit<class_LineEdit>` **get_line_edit**\ (\ ) :ref:`🔗<class_FileDialog_method_get_line_edit>`
Restituisce il LineEdit per il file selezionato.
\ **Attenzione:** Questo è un nodo interno obbligatorio, rimuoverlo e liberarlo potrebbe causare un crash. Se desideri nascondere esso o uno dei suoi figli, usa la loro proprietà :ref:`CanvasItem.visible<class_CanvasItem_property_visible>`.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_get_option_default:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_option_default**\ (\ option\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_FileDialog_method_get_option_default>`
Restituisce l'indice di valore predefinito dell':ref:`OptionButton<class_OptionButton>` o della :ref:`CheckBox<class_CheckBox>` con l'indice ``option``.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_get_option_name:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_option_name**\ (\ option\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_FileDialog_method_get_option_name>`
Restituisce il nome dell':ref:`OptionButton<class_OptionButton>` o della :ref:`CheckBox<class_CheckBox>` con l'indice ``option``.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_get_option_values:
.. rst-class:: classref-method
:ref:`PackedStringArray<class_PackedStringArray>` **get_option_values**\ (\ option\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_FileDialog_method_get_option_values>`
Restituisce un array di valori dell':ref:`OptionButton<class_OptionButton>` con l'indice ``option``.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_get_selected_options:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_selected_options**\ (\ ) |const| :ref:`🔗<class_FileDialog_method_get_selected_options>`
Restituisce un :ref:`Dictionary<class_Dictionary>` con i valori selezionati degli :ref:`OptionButton<class_OptionButton>` e/o :ref:`CheckBox<class_CheckBox>` aggiuntivi. Le chiavi del :ref:`Dictionary<class_Dictionary>` sono i nomi e i valori sono gli indici dei valori selezionati.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_get_vbox:
.. rst-class:: classref-method
:ref:`VBoxContainer<class_VBoxContainer>` **get_vbox**\ (\ ) :ref:`🔗<class_FileDialog_method_get_vbox>`
Restituisce il contenitore verticale della finestra di dialogo, a cui è possibile aggiungere controlli personalizzati.
\ **Attenzione:** Questo è un nodo interno necessario, rimuoverlo e liberarlo potrebbe causare un crash. Se si desidera nascondere esso o uno dei suoi figli, utilizza le loro proprietà :ref:`CanvasItem.visible<class_CanvasItem_property_visible>`.
\ **Nota:** Le modifiche apportate a questo nodo vengono ignorate dalle finestre native di dialogo dei file. Utilizza invece :ref:`add_option()<class_FileDialog_method_add_option>` per aggiungere elementi personalizzati alla finestra di dialogo.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_invalidate:
.. rst-class:: classref-method
|void| **invalidate**\ (\ ) :ref:`🔗<class_FileDialog_method_invalidate>`
Invalida e aggiorna la lista dei contenuti attuale nella finestra di dialogo.
\ **Nota:** Questo metodo non fa nulla sulle finestre di dialogo dei file native.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_is_customization_flag_enabled:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`\ ) |const| :ref:`🔗<class_FileDialog_method_is_customization_flag_enabled>`
Restituisce ``true`` se il ``flag`` specificato è abilitato.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_set_customization_flag_enabled:
.. rst-class:: classref-method
|void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization<enum_FileDialog_Customization>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_FileDialog_method_set_customization_flag_enabled>`
Attiva/disattiva il ``flag`` di personalizzazione specificato, consentendo di personalizzare le funzionalità disponibili in questo **FileDialog**. Per le opzioni, vedi :ref:`Customization<enum_FileDialog_Customization>`.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_set_option_default:
.. rst-class:: classref-method
|void| **set_option_default**\ (\ option\: :ref:`int<class_int>`, default_value_index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_FileDialog_method_set_option_default>`
Imposta l'indice di valore predefinito dell':ref:`OptionButton<class_OptionButton>` o della :ref:`CheckBox<class_CheckBox>` con l'indice ``option``.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_set_option_name:
.. rst-class:: classref-method
|void| **set_option_name**\ (\ option\: :ref:`int<class_int>`, name\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileDialog_method_set_option_name>`
Imposta il nome dell':ref:`OptionButton<class_OptionButton>` o della :ref:`CheckBox<class_CheckBox>` con l'indice ``option``.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_method_set_option_values:
.. rst-class:: classref-method
|void| **set_option_values**\ (\ option\: :ref:`int<class_int>`, values\: :ref:`PackedStringArray<class_PackedStringArray>`\ ) :ref:`🔗<class_FileDialog_method_set_option_values>`
Imposta i valori di opzione dell':ref:`OptionButton<class_OptionButton>` con l'indice ``option``.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà del tema
------------------------------------------------------------------------
.. _class_FileDialog_theme_color_file_disabled_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **file_disabled_color** = ``Color(1, 1, 1, 0.25)`` :ref:`🔗<class_FileDialog_theme_color_file_disabled_color>`
La tinta di colore per i file disabilitati (quando **FileDialog** è usato in modalità cartella aperta).
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_color_file_icon_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **file_icon_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_FileDialog_theme_color_file_icon_color>`
Il colore di modulazione applicato all'icona del file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_color_folder_icon_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **folder_icon_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_FileDialog_theme_color_folder_icon_color>`
Il colore di modulazione applicato all'icona della cartella.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_constant_thumbnail_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **thumbnail_size** = ``64`` :ref:`🔗<class_FileDialog_theme_constant_thumbnail_size>`
La dimensione delle icone in miniatura quando :ref:`DISPLAY_THUMBNAILS<class_FileDialog_constant_DISPLAY_THUMBNAILS>` è abilitato.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_back_folder:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **back_folder** :ref:`🔗<class_FileDialog_theme_icon_back_folder>`
Icona personalizzata per la freccia indietro.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_create_folder:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **create_folder** :ref:`🔗<class_FileDialog_theme_icon_create_folder>`
Icona personalizzata per il pulsante Crea cartella.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_favorite:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **favorite** :ref:`🔗<class_FileDialog_theme_icon_favorite>`
Icona personalizzata per il pulsante Preferiti delle cartelle.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_favorite_down:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **favorite_down** :ref:`🔗<class_FileDialog_theme_icon_favorite_down>`
Icona personalizzata per il pulsante per spostare in basso una voce aggiunta ai preferiti.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_favorite_up:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **favorite_up** :ref:`🔗<class_FileDialog_theme_icon_favorite_up>`
Icona personalizzata per il pulsante per spostare in alto una voce aggiunta ai preferiti.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_file:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **file** :ref:`🔗<class_FileDialog_theme_icon_file>`
Icona personalizzata per i file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_file_thumbnail:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **file_thumbnail** :ref:`🔗<class_FileDialog_theme_icon_file_thumbnail>`
Icona per i file in modalità miniatura.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_folder:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **folder** :ref:`🔗<class_FileDialog_theme_icon_folder>`
Icona personalizzata per le cartelle.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_folder_thumbnail:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **folder_thumbnail** :ref:`🔗<class_FileDialog_theme_icon_folder_thumbnail>`
Icona per le cartelle in modalità miniatura.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_forward_folder:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **forward_folder** :ref:`🔗<class_FileDialog_theme_icon_forward_folder>`
Icona personalizzata per la freccia avanti.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_list_mode:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **list_mode** :ref:`🔗<class_FileDialog_theme_icon_list_mode>`
Icona per il pulsante che abilita la modalità elenco.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_parent_folder:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **parent_folder** :ref:`🔗<class_FileDialog_theme_icon_parent_folder>`
Icona personalizzata per la freccia della cartella padre.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_reload:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **reload** :ref:`🔗<class_FileDialog_theme_icon_reload>`
Icona personalizzata per il pulsante di ricarica.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_sort:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **sort** :ref:`🔗<class_FileDialog_theme_icon_sort>`
Icona personalizzata per il menu delle opzioni di ordinamento.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_thumbnail_mode:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **thumbnail_mode** :ref:`🔗<class_FileDialog_theme_icon_thumbnail_mode>`
Icona per il pulsante che abilita la modalità miniatura.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_toggle_filename_filter:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **toggle_filename_filter** :ref:`🔗<class_FileDialog_theme_icon_toggle_filename_filter>`
Icona personalizzata per l'Interruttore del filtro per i nomi di file.
.. rst-class:: classref-item-separator
----
.. _class_FileDialog_theme_icon_toggle_hidden:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **toggle_hidden** :ref:`🔗<class_FileDialog_theme_icon_toggle_hidden>`
Icona personalizzata per l'Interruttore dei file nascosti.
.. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)`
.. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)`
.. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)`
.. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)`
.. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)`
.. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)`
.. |void| replace:: :abbr:`void (Nessun valore restituito.)`