mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
1275 lines
71 KiB
ReStructuredText
1275 lines
71 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_FileDialog:
|
||
|
||
FileDialog
|
||
==========
|
||
|
||
**Успадковує:** :ref:`ConfirmationDialog<class_ConfirmationDialog>` **<** :ref:`AcceptDialog<class_AcceptDialog>` **<** :ref:`Window<class_Window>` **<** :ref:`Viewport<class_Viewport>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
||
|
||
Діалогове вікно вибору файлів або каталогів у файловій системі.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Опис
|
||
--------
|
||
|
||
**FileDialog** - це діалогове вікно, яке використовується для вибору файлів та каталогів у файловій системі. Підтримує фільтрувальні маски. **FileDialog** автоматично встановлює назву вікна згідно з :ref:`файл_mode<class_FileDialog_property_файл_mode>`. Якщо ви хочете використовувати користувацьке звання, відключити це за допомогою параметра :ref:`mode_overrides_title<class_FileDialog_property_mode_overrides_title>` до ``false``.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Властивості
|
||
----------------------
|
||
|
||
.. 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
|
||
|
||
Методи
|
||
------------
|
||
|
||
.. 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
|
||
|
||
Властивості теми
|
||
--------------------------------
|
||
|
||
.. 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
|
||
|
||
Сигнали
|
||
--------------
|
||
|
||
.. _class_FileDialog_signal_dir_selected:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**dir_selected**\ (\ dir\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileDialog_signal_dir_selected>`
|
||
|
||
Увімкніть, коли користувач вибирає каталог.
|
||
|
||
.. 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>`
|
||
|
||
Увімкніть, коли користувач вибирає файл, натиснувши кнопку **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>`
|
||
|
||
Видається, коли змінюється фільтр імен файлів.
|
||
|
||
.. 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>`
|
||
|
||
Увімкнено, коли користувач вибирає декілька файлів.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Переліки
|
||
----------------
|
||
|
||
.. _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``
|
||
|
||
Діалогове вікно дозволяє вибрати один, і тільки один файл.
|
||
|
||
.. _class_FileDialog_constant_FILE_MODE_OPEN_FILES:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_OPEN_FILES** = ``1``
|
||
|
||
Діалогове вікно дозволяє вибрати декілька файлів.
|
||
|
||
.. _class_FileDialog_constant_FILE_MODE_OPEN_DIR:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_OPEN_DIR** = ``2``
|
||
|
||
Діалогове вікно дозволяє вибрати каталог, вимкнути вибір будь-якого файлу.
|
||
|
||
.. _class_FileDialog_constant_FILE_MODE_OPEN_ANY:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_OPEN_ANY** = ``3``
|
||
|
||
Діалогове вікно дозволяє вибрати один файл або каталог.
|
||
|
||
.. _class_FileDialog_constant_FILE_MODE_SAVE_FILE:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`FileMode<enum_FileDialog_FileMode>` **FILE_MODE_SAVE_FILE** = ``4``
|
||
|
||
У діалоговому вікні буде попереджати, коли існує файл.
|
||
|
||
.. 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``
|
||
|
||
Діалогове вікно дозволяє отримати доступ до файлів за допомогою :ref:`Resource<class_Resource>` (``res://``).
|
||
|
||
.. _class_FileDialog_constant_ACCESS_USERDATA:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`Access<enum_FileDialog_Access>` **ACCESS_USERDATA** = ``1``
|
||
|
||
Діалогове вікно дозволяє отримати доступ до файлів під шляхом даних користувача (``user://``).
|
||
|
||
.. _class_FileDialog_constant_ACCESS_FILESYSTEM:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`Access<enum_FileDialog_Access>` **ACCESS_FILESYSTEM** = ``2``
|
||
|
||
Діалогове вікно дозволяє отримати доступ до файлів на всій файловій системі.
|
||
|
||
.. 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``
|
||
|
||
У діалоговому вікні файли відображаються у вигляді сітки мініатюр. Використовуйте :ref:`thumbnail_size<class_FileDialog_theme_constant_thumbnail_size>`, щоб налаштувати їхній розмір.
|
||
|
||
.. _class_FileDialog_constant_DISPLAY_LIST:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`DisplayMode<enum_FileDialog_DisplayMode>` **DISPLAY_LIST** = ``1``
|
||
|
||
У діалоговому вікні файли відображаються у вигляді списку імен файлів.
|
||
|
||
.. 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``
|
||
|
||
Вмикає/вимикає видимість кнопки обраного та списку обраного в лівій частині діалогового вікна.
|
||
|
||
Еквівалентно :ref:`hidden_files_toggle_enabled<class_FileDialog_property_hidden_files_toggle_enabled>`.
|
||
|
||
.. _class_FileDialog_constant_CUSTOMIZATION_CREATE_FOLDER:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`Customization<enum_FileDialog_Customization>` **CUSTOMIZATION_CREATE_FOLDER** = ``1``
|
||
|
||
Якщо ввімкнено, відображається кнопка для створення нових каталогів (при використанні :ref:`FILE_MODE_OPEN_DIR<class_FileDialog_constant_FILE_MODE_OPEN_DIR>`, :ref:`FILE_MODE_OPEN_ANY<class_FileDialog_constant_FILE_MODE_OPEN_ANY>` або :ref:`FILE_MODE_SAVE_FILE<class_FileDialog_constant_FILE_MODE_SAVE_FILE>`).
|
||
|
||
Еквівалентно :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``
|
||
|
||
Якщо ввімкнено, відображається кнопка перемикання фільтра файлів.
|
||
|
||
Еквівалентно :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``
|
||
|
||
Якщо ввімкнено, відображається кнопка параметрів сортування файлів.
|
||
|
||
Еквівалентно :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``
|
||
|
||
Якщо ввімкнено, відображається кнопка перемикання обраного та список обраного в лівій частині діалогового вікна.
|
||
|
||
Еквівалентно :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``
|
||
|
||
Якщо увімкнено, список нещодавно використаних каталогів відображається у лівій частині діалогового вікна.
|
||
|
||
Еквівалентно :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``
|
||
|
||
Якщо ввімкнено, відображається кнопка перемикання розкладки (список/мініатюри).
|
||
|
||
Еквівалентно :ref:`layout_toggle_enabled<class_FileDialog_property_layout_toggle_enabled>`.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описи властивостей
|
||
------------------------------------
|
||
|
||
.. _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**\ (\ )
|
||
|
||
Область доступу до файлової системи.
|
||
|
||
\ **Попередження:** У веб-збірках FileDialog не може отримати доступ до файлової системи хоста. В ізольованих середовищах Linux та macOS :ref:`use_native_dialog<class_FileDialog_property_use_native_dialog>` автоматично використовується для обмеження доступу до файлової системи хоста.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
Поточний робочий каталог файлового діалогу.
|
||
|
||
\ **Примітка:** Для рідних діалогів файлів, ця властивість тільки обробляється як підказка, і не може бути поважаний конкретними впровадженнями ОС.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
В даний час вибраний файл діалогу файлів.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
В даний час вибраний шлях файлу діалогу.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
Режим відображення списку файлів у діалоговому вікні.
|
||
|
||
.. 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|
|
||
|
||
Якщо ``true``, відображається кнопка перемикання обраного та список обраного у лівій частині діалогового вікна.
|
||
|
||
.. 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|
|
||
|
||
Якщо ``true``, відображається кнопка перемикання фільтра файлів.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
Режим відкриття або збереження діалогового вікна, який впливає на поведінку вибору.
|
||
|
||
.. 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|
|
||
|
||
Якщо ``true``, відображається кнопка параметрів сортування файлів.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
Фільтр імен файлів (незалежний від регістру). Якщо встановлено непорожній рядок, відображатимуться лише файли, які містять цей підрядок. :ref:`filename_filter<class_FileDialog_property_filename_filter>` користувач може редагувати за допомогою кнопки фільтра у верхній частині діалогового вікна файлу.
|
||
|
||
Дивіться також :ref:`filters<class_FileDialog_property_filters>`, який слід використовувати для обмеження типів файлів, які можна вибрати, замість :ref:`filename_filter<class_FileDialog_property_filename_filter>`, який має встановлювати користувач.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
Доступні фільтри типів файлів. Кожен рядок фільтра в масиві має бути відформатований таким чином: ``*.png,*.jpg,*.jpeg;файли зображень;зображення/png,зображення/jpeg``. Текст опису фільтра необов’язковий і його можна опустити. Слід завжди встановлювати розширення файлів і тип MIME.
|
||
|
||
\ **Примітка.** Вбудоване діалогове вікно файлів і діалогове вікно файлів Windows підтримують лише розширення файлів, тоді як діалогові вікна файлів Android, Linux і macOS також підтримують типи 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|
|
||
|
||
Якщо ``true``, відображається кнопка для створення нових каталогів (при використанні :ref:`FILE_MODE_OPEN_DIR<class_FileDialog_constant_FILE_MODE_OPEN_DIR>`, :ref:`FILE_MODE_OPEN_ANY<class_FileDialog_constant_FILE_MODE_OPEN_ANY>` або :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|
|
||
|
||
Якщо ``true``, відображається кнопка перемикання прихованих файлів.
|
||
|
||
.. 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|
|
||
|
||
Якщо ``true``, відображається кнопка перемикання розкладки (список/мініатюри).
|
||
|
||
.. 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**\ (\ )
|
||
|
||
Якщо ``true``, змінивши ``пам'ятний файл_mode`` майно буде встановлено назву вікна відповідно (наприклад, налаштування :ref:`file_mode<class_FileDialog_property_file_mode>` до :ref:`FILE_MODE_OPEN_FILE<class_FileDialog_constant_FILE_MODE_OPEN_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**\ (\ )
|
||
|
||
Кількість додаткових :ref:`OptionButton<class_OptionButton>`\ s і :ref:`CheckBox<class_CheckBox>`\ es в діалоговому вікні.
|
||
|
||
.. 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|
|
||
|
||
Якщо значення ``true``, список нещодавно використаних каталогів відображається у лівій частині діалогового вікна.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
Якщо не спрага, то заданий підпам'як буде "роот" цього **FileDialog**, тобто користувач не зможе перейти до свого батьківського каталогу.
|
||
|
||
\ **Примітка:** Ця властивість ігнорується рідними діалогами файлів.
|
||
|
||
.. 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**\ (\ )
|
||
|
||
Якщо ``true``, діалогове вікно покаже приховані файли.
|
||
|
||
\ **Примітка:** Ця властивість ігнорується рідними діалоговими вікнами файлів на Android і 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**\ (\ )
|
||
|
||
Якщо ``true``, і якщо підтримується поточним :ref:`DisplayServer<class_DisplayServer>`, замість власного буде використовуватися рідне діалогове вікно ОС.
|
||
|
||
\ **Примітка:** На Android це підтримується лише для пристроїв Android 10+ та під час використання :ref:`ACCESS_FILESYSTEM<class_FileDialog_constant_ACCESS_FILESYSTEM>`. Для режиму доступу :ref:`ACCESS_RESOURCES<class_FileDialog_constant_ACCESS_RESOURCES>` та :ref:`ACCESS_USERDATA<class_FileDialog_constant_ACCESS_USERDATA>` система повернеться до власного FileDialog.
|
||
|
||
\ **Примітка:** У Linux та macOS ізольовані програми завжди використовують рідні діалогові вікна для доступу до файлової системи хоста.
|
||
|
||
\ **Примітка:** У macOS ізольовані програми зберігатимуть закладки з областю безпеки, щоб зберегти доступ до відкритих папок протягом кількох сеансів. Використовуйте :ref:`OS.get_granted_permissions()<class_OS_method_get_granted_permissions>`, щоб отримати список збережених закладок.
|
||
|
||
\ **Примітка:** Рідні діалогові вікна ізольовані від базового процесу, властивості діалогового вікна файлу не можна змінити після того, як діалогове вікно відображається.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описи методів
|
||
--------------------------
|
||
|
||
.. _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>`
|
||
|
||
Додає параметр ``filter`` для імені файлу, розділеного комами, до **FileDialog** з необов'язковим ``description``, який обмежує вибір файлів.
|
||
|
||
\ ``filter`` повинен мати вигляд ``"filename.extension"``, де filename та extension можуть бути ``*`` для відповідності будь-якому рядку. Фільтри, що починаються з ``.`` (тобто пусті імена файлів), не допускаються.
|
||
|
||
Наприклад, ``filter`` з ``"*.png, *.jpg"`` та ``description`` з ``"Images"`` призведе до тексту фільтра "Images (\*.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>`
|
||
|
||
Додає додатковий :ref:`OptionButton<class_OptionButton>` до діалогу файлів. Якщо ``values`` порожній, то замість цього додається :ref:`CheckBox<class_CheckBox>`.
|
||
|
||
\ ``default_value_index`` повинен бути індексом значення в ``values``. Якщо ``values`` є порожнім, він повинен бути або ``1`` (увімкнений), або ``0`` (вимкнений).
|
||
|
||
.. 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>`
|
||
|
||
Очистіть фільтр імен файлів.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FileDialog_method_clear_filters:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
|void| **clear_filters**\ (\ ) :ref:`🔗<class_FileDialog_method_clear_filters>`
|
||
|
||
Очистити всі додані фільтри в діалоговому вікні.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FileDialog_method_deselect_all:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
|void| **deselect_all**\ (\ ) :ref:`🔗<class_FileDialog_method_deselect_all>`
|
||
|
||
Очистити всі вибрані елементи в діалоговому вікні.
|
||
|
||
.. 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>`
|
||
|
||
Повертає рядок редагування для вибраного файлу.
|
||
|
||
\ **Налаштування:** Це необхідний внутрішній вузол, видаляючи і звільняючи його може призвести до аварії. Якщо ви хочете приховати його або будь-який з своїх дітей, скористайтеся їх :ref:`CanvasItem.pic<class_CanvasItem_property_pic>`.
|
||
|
||
.. 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>`
|
||
|
||
Повертає значення за замовчуванням індексу :ref:`OptionButton<class_OptionButton>` або :ref:`CheckBox<class_CheckBox>` з індексом ``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>`
|
||
|
||
Повертає назву :ref:`OptionButton<class_OptionButton>` або :ref:`CheckBox<class_CheckBox>` з індексом ``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>`
|
||
|
||
Повертає масив значень :ref:`OptionButton<class_OptionButton>` з індексом ``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>`
|
||
|
||
Повертає :ref:`Dictionary<class_Dictionary>` з вибраними значеннями додаткових :ref:`OptionButton<class_OptionButton>` та/або :ref:`CheckBox<class_CheckBox>`. Ключі :ref:`Dictionary<class_Dictionary>` – це імена, а значення – індекси вибраних значень.
|
||
|
||
.. 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>`
|
||
|
||
Повертає вертикальний контейнер коробки діалогу, користувацькі елементи керування можна додавати до нього.
|
||
|
||
\ **Попередження:** Це необхідний внутрішній вузол, видаляючи і звільняючи його може призвести до аварії. Якщо ви хочете приховати його або будь-який з своїх дітей, скористайтеся їх :ref:`CanvasItem.pic<class_CanvasItem_property_pic>`.
|
||
|
||
\ **Примітка:** Зміни до цієї вершини ігноруються рідними діалогами файлів, використовуйте :ref:`add_option()<class_FileDialog_method_add_option>`, щоб додати користувацькі елементи до діалогу замість.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FileDialog_method_invalidate:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
|void| **invalidate**\ (\ ) :ref:`🔗<class_FileDialog_method_invalidate>`
|
||
|
||
Неоцінити і оновити поточний список вмісту діалогу.
|
||
|
||
\ **Примітка:** Цей метод не робить нічого на рідних діалогах файлів.
|
||
|
||
.. 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>`
|
||
|
||
Повертає ``true``, якщо вказаний ``flag`` увімкнено.
|
||
|
||
.. 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>`
|
||
|
||
Вмикає/вимикає вказане налаштування ``flag``, що дозволяє налаштовувати функції, доступні в цьому **FileDialog**. Див. :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>`
|
||
|
||
Встановлює індекс значення за замовчуванням для :ref:`OptionButton<class_OptionButton>` або :ref:`CheckBox<class_CheckBox>` з індексом ``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>`
|
||
|
||
Встановлює назву :ref:`OptionButton<class_OptionButton>` або :ref:`CheckBox<class_CheckBox>` з індексом ``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>`
|
||
|
||
Встановлює значення параметрів :ref:`OptionButton<class_OptionButton>` з індексом ``option``.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описи тематичної нерухомості
|
||
--------------------------------------------------------
|
||
|
||
.. _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>`
|
||
|
||
Колірний відтінок для відключених файлів (коли **FileDialog** використовується в режимі відкритої папки).
|
||
|
||
.. 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>`
|
||
|
||
Кольорова модуляція наноситься на іконку файлу.
|
||
|
||
.. 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>`
|
||
|
||
Кольорова модуляція наноситься на іконку папки.
|
||
|
||
.. 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>`
|
||
|
||
Розмір мініатюр, коли ввімкнено :ref:`DISPLAY_THUMBNAILS<class_FileDialog_constant_DISPLAY_THUMBNAILS>`.
|
||
|
||
.. 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>`
|
||
|
||
Спеціальна ікона для стріли.
|
||
|
||
.. 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>`
|
||
|
||
Спеціальна ікона для створення кнопки папки.
|
||
|
||
.. 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>`
|
||
|
||
Спеціальна іконка для кнопки улюбленої папки.
|
||
|
||
.. 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>`
|
||
|
||
Спеціальна піктограма для кнопки переміщення вниз по обраному запису.
|
||
|
||
.. 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>`
|
||
|
||
Спеціальна піктограма для кнопки переміщення вгору по обраному запису.
|
||
|
||
.. 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>`
|
||
|
||
Спеціальна ікона для файлів.
|
||
|
||
.. 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>`
|
||
|
||
Піктограма файлів у режимі мініатюр.
|
||
|
||
.. 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>`
|
||
|
||
Спеціальна ікона для папок.
|
||
|
||
.. 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>`
|
||
|
||
Піктограма папок у режимі мініатюр.
|
||
|
||
.. 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>`
|
||
|
||
Користувальницькі іконки для стрілки.
|
||
|
||
.. 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>`
|
||
|
||
Піктограма кнопки, яка вмикає режим списку.
|
||
|
||
.. 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>`
|
||
|
||
Користувальницькі іконки для стрілки папки батьків.
|
||
|
||
.. 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>`
|
||
|
||
Настроювання іконки для кнопки перевантаження.
|
||
|
||
.. 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>`
|
||
|
||
Спеціальна піктограма для меню параметрів сортування.
|
||
|
||
.. 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>`
|
||
|
||
Піктограма кнопки, яка вмикає режим мініатюр.
|
||
|
||
.. 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>`
|
||
|
||
Настроювана піктограма для кнопки-перемикача фільтра імен файлів.
|
||
|
||
.. 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>`
|
||
|
||
Користувальницька ікона для окуляри прихована кнопка.
|
||
|
||
.. |virtual| replace:: :abbr:`virtual (Зазвичай, цей метод перевизначається користувачем, щоб він мав вплив.)`
|
||
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
||
.. |const| replace:: :abbr:`const (Цей метод не має побічних ефектів. Не змінює ніяку змінну екземпляра об'єкта.)`
|
||
.. |vararg| replace:: :abbr:`vararg (Цей метод приймає будь-яке число аргументів після описаних тут.)`
|
||
.. |constructor| replace:: :abbr:`constructor (Цей метод використовується для побудови типів.)`
|
||
.. |static| replace:: :abbr:`static (Цей метод не потребує екземпляра для виклику, його можна викликати безпосередньо за допомогою назви класу.)`
|
||
.. |operator| replace:: :abbr:`operator (Цей метод описує дійсний оператор для взаємодії з цим типом як з лівим операндом.)`
|
||
.. |bitfield| replace:: :abbr:`BitField (Це значення є цілим числом, складеним у вигляді бітової маски з наступних прапорів.)`
|
||
.. |void| replace:: :abbr:`void (Значення не повертається.)`
|