mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
244 lines
18 KiB
ReStructuredText
244 lines
18 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_EditorInspector:
|
||
|
||
EditorInspector
|
||
===============
|
||
|
||
**Наследует:** :ref:`ScrollContainer<class_ScrollContainer>` **<** :ref:`Container<class_Container>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
||
|
||
Элемент управления, используемый для редактирования свойств объекта.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
Это элемент управления, реализующий редактирование свойств в диалоговых окнах настроек редактора, панели инспектора и т. д. Чтобы получить **EditorInspector**, используемый в панели инспектора редактора, используйте :ref:`EditorInterface.get_inspector()<class_EditorInterface_method_get_inspector>`.
|
||
|
||
\ **EditorInspector** покажет свойства в том же порядке, что и массив, возвращаемый :ref:`Object.get_property_list()<class_Object_method_get_property_list>`.
|
||
|
||
Если имя свойства похоже на путь (т. е. содержит косые черты), **EditorInspector** создаст вложенные разделы для «каталогов» по пути. Например, если свойство называется ``highlighting/gdscript/node_path_color``, оно будет показано как «Node Path Color» внутри раздела «GDScript», вложенного в раздел «Highlighting».
|
||
|
||
Если свойство имеет :ref:`@GlobalScope.PROPERTY_USAGE_GROUP<class_@GlobalScope_constant_PROPERTY_USAGE_GROUP>`, оно сгруппирует последующие свойства, имя которых начинается со строки подсказки свойства. Группа заканчивается, когда свойство не начинается с этой строки подсказки или когда начинается новая группа. Пустое имя группы фактически завершает текущую группу. **EditorInspector** создаст раздел верхнего уровня для каждой группы. Например, если свойство с групповым использованием называется ``Collide With``, а его строка подсказки — ``collide_with_``, последующее свойство ``collide_with_area`` будет показано как «Area» внутри раздела «Collide With». Также есть особый случай: когда строка подсказки содержит имя свойства, это свойство также группируется. Это в основном помогает группировать такие свойства, как ``font``, ``font_color`` и ``font_size`` (используя строку подсказки ``font_``).
|
||
|
||
Если свойство имеет :ref:`@GlobalScope.PROPERTY_USAGE_SUBGROUP<class_@GlobalScope_constant_PROPERTY_USAGE_SUBGROUP>` использование, подгруппа будет создана так же, как и группа, и для каждой подгруппы будет создан раздел второго уровня.
|
||
|
||
\ **Примечание:** В отличие от разделов, созданных из имен свойств, подобных путям, **EditorInspector** не будет писать имя с заглавной буквы для разделов, созданных из групп. Поэтому свойства с использованием группы обычно используют имена с заглавной буквы вместо имен в стиле snake_case.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Свойства
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+----------------------------------------------------+------------------------+-------------------------------------------------------------------------------------------------+
|
||
| :ref:`bool<class_bool>` | draw_focus_border | ``true`` (overrides :ref:`ScrollContainer<class_ScrollContainer_property_draw_focus_border>`) |
|
||
+----------------------------------------------------+------------------------+-------------------------------------------------------------------------------------------------+
|
||
| :ref:`FocusMode<enum_Control_FocusMode>` | focus_mode | ``2`` (overrides :ref:`Control<class_Control_property_focus_mode>`) |
|
||
+----------------------------------------------------+------------------------+-------------------------------------------------------------------------------------------------+
|
||
| :ref:`bool<class_bool>` | follow_focus | ``true`` (overrides :ref:`ScrollContainer<class_ScrollContainer_property_follow_focus>`) |
|
||
+----------------------------------------------------+------------------------+-------------------------------------------------------------------------------------------------+
|
||
| :ref:`ScrollMode<enum_ScrollContainer_ScrollMode>` | horizontal_scroll_mode | ``0`` (overrides :ref:`ScrollContainer<class_ScrollContainer_property_horizontal_scroll_mode>`) |
|
||
+----------------------------------------------------+------------------------+-------------------------------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Методы
|
||
------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+---------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| |void| | :ref:`edit<class_EditorInspector_method_edit>`\ (\ object\: :ref:`Object<class_Object>`\ ) |
|
||
+---------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`Object<class_Object>` | :ref:`get_edited_object<class_EditorInspector_method_get_edited_object>`\ (\ ) |
|
||
+---------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`String<class_String>` | :ref:`get_selected_path<class_EditorInspector_method_get_selected_path>`\ (\ ) |const| |
|
||
+---------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`EditorProperty<class_EditorProperty>` | :ref:`instantiate_property_editor<class_EditorInspector_method_instantiate_property_editor>`\ (\ object\: :ref:`Object<class_Object>`, type\: :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>`, path\: :ref:`String<class_String>`, hint\: :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>`, hint_text\: :ref:`String<class_String>`, usage\: :ref:`int<class_int>`, wide\: :ref:`bool<class_bool>` = false\ ) |static| |
|
||
+---------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Сигналы
|
||
--------------
|
||
|
||
.. _class_EditorInspector_signal_edited_object_changed:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**edited_object_changed**\ (\ ) :ref:`🔗<class_EditorInspector_signal_edited_object_changed>`
|
||
|
||
Генерируется при изменении объекта, редактируемого инспектором.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_signal_object_id_selected:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**object_id_selected**\ (\ id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_EditorInspector_signal_object_id_selected>`
|
||
|
||
Вызывается при нажатии кнопки Edit :ref:`Object<class_Object>` в инспекторе. В основном используется в инспекторе дерева удаленной сцены.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_signal_property_deleted:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**property_deleted**\ (\ property\: :ref:`String<class_String>`\ ) :ref:`🔗<class_EditorInspector_signal_property_deleted>`
|
||
|
||
Выдается при удалении свойства из инспектора.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_signal_property_edited:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**property_edited**\ (\ property\: :ref:`String<class_String>`\ ) :ref:`🔗<class_EditorInspector_signal_property_edited>`
|
||
|
||
Выдается при редактировании свойства в инспекторе.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_signal_property_keyed:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**property_keyed**\ (\ property\: :ref:`String<class_String>`, value\: :ref:`Variant<class_Variant>`, advance\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_EditorInspector_signal_property_keyed>`
|
||
|
||
Вызывается, когда свойство задается в инспекторе. Свойства могут быть запрограммированы, нажав на значок «ключ» рядом со свойством, когда панель «Анимация» переключена.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_signal_property_selected:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**property_selected**\ (\ property\: :ref:`String<class_String>`\ ) :ref:`🔗<class_EditorInspector_signal_property_selected>`
|
||
|
||
Выдается при выборе свойства в инспекторе.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_signal_property_toggled:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**property_toggled**\ (\ property\: :ref:`String<class_String>`, checked\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_EditorInspector_signal_property_toggled>`
|
||
|
||
Вызывается при переключении логического свойства в инспекторе.
|
||
|
||
\ **Примечание:** Этот сигнал никогда не вызывается, если включено внутреннее свойство ``autoclear``. Поскольку это свойство всегда включено в инспекторе редактора, этот сигнал никогда не вызывается самим редактором.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_signal_resource_selected:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**resource_selected**\ (\ resource\: :ref:`Resource<class_Resource>`, path\: :ref:`String<class_String>`\ ) :ref:`🔗<class_EditorInspector_signal_resource_selected>`
|
||
|
||
Выдается при выборе ресурса в инспекторе.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_signal_restart_requested:
|
||
|
||
.. rst-class:: classref-signal
|
||
|
||
**restart_requested**\ (\ ) :ref:`🔗<class_EditorInspector_signal_restart_requested>`
|
||
|
||
Выдается, когда свойство, требующее перезапуска для применения, редактируется в инспекторе. Используется только в настройках проекта и настройках редактора.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания метода
|
||
------------------------------
|
||
|
||
.. _class_EditorInspector_method_edit:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
|void| **edit**\ (\ object\: :ref:`Object<class_Object>`\ ) :ref:`🔗<class_EditorInspector_method_edit>`
|
||
|
||
Показывает свойства указанного ``object`` в этом инспекторе для редактирования. Чтобы очистить инспектор, вызовите этот метод с ``null``.
|
||
|
||
\ **Примечание:** Если вы хотите редактировать объект в главном инспекторе редактора, используйте вместо этого методы ``edit_*`` в :ref:`EditorInterface<class_EditorInterface>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_method_get_edited_object:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`Object<class_Object>` **get_edited_object**\ (\ ) :ref:`🔗<class_EditorInspector_method_get_edited_object>`
|
||
|
||
Возвращает объект, выбранный в данный момент в этом инспекторе.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_method_get_selected_path:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`String<class_String>` **get_selected_path**\ (\ ) |const| :ref:`🔗<class_EditorInspector_method_get_selected_path>`
|
||
|
||
Получает путь к текущему выбранному свойству.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_EditorInspector_method_instantiate_property_editor:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`EditorProperty<class_EditorProperty>` **instantiate_property_editor**\ (\ object\: :ref:`Object<class_Object>`, type\: :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>`, path\: :ref:`String<class_String>`, hint\: :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>`, hint_text\: :ref:`String<class_String>`, usage\: :ref:`int<class_int>`, wide\: :ref:`bool<class_bool>` = false\ ) |static| :ref:`🔗<class_EditorInspector_method_instantiate_property_editor>`
|
||
|
||
Создает редактор свойств, который может использоваться пользовательским интерфейсом плагина для редактирования указанного свойства ``object``.
|
||
|
||
.. |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 (Нет возвращаемого значения.)`
|