mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
1275 lines
65 KiB
ReStructuredText
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.)`
|