Files
godot-docs-l10n/classes/zh_Hans/class_filesystemdock.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

212 lines
7.6 KiB
ReStructuredText

:github_url: hide
.. _class_FileSystemDock:
FileSystemDock
==============
**继承:** :ref:`EditorDock<class_EditorDock>` **<** :ref:`MarginContainer<class_MarginContainer>` **<** :ref:`Container<class_Container>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
Godot 编辑器中用于管理项目文件的停靠面板。
.. rst-class:: classref-introduction-group
描述
----
这个类仅在 :ref:`EditorPlugin<class_EditorPlugin>` 中可用,无法实例化。可以使用 :ref:`EditorInterface.get_file_system_dock()<class_EditorInterface_method_get_file_system_dock>` 访问。
虽然 **FileSystemDock** 没有暴露任何操作文件的方法,但是你可以监听各种与文件相关的信号。
.. rst-class:: classref-reftable-group
方法
----
.. table::
:widths: auto
+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_resource_tooltip_plugin<class_FileSystemDock_method_add_resource_tooltip_plugin>`\ (\ plugin\: :ref:`EditorResourceTooltipPlugin<class_EditorResourceTooltipPlugin>`\ ) |
+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`navigate_to_path<class_FileSystemDock_method_navigate_to_path>`\ (\ path\: :ref:`String<class_String>`\ ) |
+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_resource_tooltip_plugin<class_FileSystemDock_method_remove_resource_tooltip_plugin>`\ (\ plugin\: :ref:`EditorResourceTooltipPlugin<class_EditorResourceTooltipPlugin>`\ ) |
+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
信号
----
.. _class_FileSystemDock_signal_display_mode_changed:
.. rst-class:: classref-signal
**display_mode_changed**\ (\ ) :ref:`🔗<class_FileSystemDock_signal_display_mode_changed>`
用户切换文件显示模式或分隔模式时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_file_removed:
.. rst-class:: classref-signal
**file_removed**\ (\ file\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileSystemDock_signal_file_removed>`
给定的文件 ``file`` 被移除时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_files_moved:
.. rst-class:: classref-signal
**files_moved**\ (\ old_file\: :ref:`String<class_String>`, new_file\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileSystemDock_signal_files_moved>`
文件从 ``old_file`` 路径移动到 ``new_file`` 路径时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_folder_color_changed:
.. rst-class:: classref-signal
**folder_color_changed**\ (\ ) :ref:`🔗<class_FileSystemDock_signal_folder_color_changed>`
当目录改变颜色时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_folder_moved:
.. rst-class:: classref-signal
**folder_moved**\ (\ old_folder\: :ref:`String<class_String>`, new_folder\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileSystemDock_signal_folder_moved>`
文件夹从 ``old_folder`` 路径移动到 ``new_folder`` 路径时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_folder_removed:
.. rst-class:: classref-signal
**folder_removed**\ (\ folder\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileSystemDock_signal_folder_removed>`
给定的文件夹 ``folder`` 被移除时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_inherit:
.. rst-class:: classref-signal
**inherit**\ (\ file\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileSystemDock_signal_inherit>`
创建新场景,且该场景继承自位于 ``file`` 路径的场景时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_instantiate:
.. rst-class:: classref-signal
**instantiate**\ (\ files\: :ref:`PackedStringArray<class_PackedStringArray>`\ ) :ref:`🔗<class_FileSystemDock_signal_instantiate>`
在编辑器中实例化给定场景时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_resource_removed:
.. rst-class:: classref-signal
**resource_removed**\ (\ resource\: :ref:`Resource<class_Resource>`\ ) :ref:`🔗<class_FileSystemDock_signal_resource_removed>`
外部资源 ``resource`` 的对应文件被移除时发出。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_signal_selection_changed:
.. rst-class:: classref-signal
**selection_changed**\ (\ ) :ref:`🔗<class_FileSystemDock_signal_selection_changed>`
Emitted when the selection changes. Use :ref:`EditorInterface.get_selected_paths()<class_EditorInterface_method_get_selected_paths>` in the connected method to get the selected paths.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
方法说明
--------
.. _class_FileSystemDock_method_add_resource_tooltip_plugin:
.. rst-class:: classref-method
|void| **add_resource_tooltip_plugin**\ (\ plugin\: :ref:`EditorResourceTooltipPlugin<class_EditorResourceTooltipPlugin>`\ ) :ref:`🔗<class_FileSystemDock_method_add_resource_tooltip_plugin>`
注册一个新的 :ref:`EditorResourceTooltipPlugin<class_EditorResourceTooltipPlugin>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_method_navigate_to_path:
.. rst-class:: classref-method
|void| **navigate_to_path**\ (\ path\: :ref:`String<class_String>`\ ) :ref:`🔗<class_FileSystemDock_method_navigate_to_path>`
将给定的 ``path`` 设置为当前选定的路径,能够确保选中的文件/目录可见。
.. rst-class:: classref-item-separator
----
.. _class_FileSystemDock_method_remove_resource_tooltip_plugin:
.. rst-class:: classref-method
|void| **remove_resource_tooltip_plugin**\ (\ plugin\: :ref:`EditorResourceTooltipPlugin<class_EditorResourceTooltipPlugin>`\ ) :ref:`🔗<class_FileSystemDock_method_remove_resource_tooltip_plugin>`
移除一个 :ref:`EditorResourceTooltipPlugin<class_EditorResourceTooltipPlugin>`\ 。如果该插件尚未添加,则失败。
.. |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 (无返回值。)`