Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
EditorInspector
Наследует: ScrollContainer < Container < Control < CanvasItem < Node < Object
Элемент управления, используемый для редактирования свойств объекта.
Описание
Это элемент управления, реализующий редактирование свойств в диалоговых окнах настроек редактора, панели инспектора и т. д. Чтобы получить EditorInspector, используемый в панели инспектора редактора, используйте EditorInterface.get_inspector().
EditorInspector покажет свойства в том же порядке, что и массив, возвращаемый Object.get_property_list().
Если имя свойства похоже на путь (т. е. содержит косые черты), EditorInspector создаст вложенные разделы для «каталогов» по пути. Например, если свойство называется highlighting/gdscript/node_path_color, оно будет показано как «Node Path Color» внутри раздела «GDScript», вложенного в раздел «Highlighting».
Если свойство имеет @GlobalScope.PROPERTY_USAGE_GROUP, оно сгруппирует последующие свойства, имя которых начинается со строки подсказки свойства. Группа заканчивается, когда свойство не начинается с этой строки подсказки или когда начинается новая группа. Пустое имя группы фактически завершает текущую группу. EditorInspector создаст раздел верхнего уровня для каждой группы. Например, если свойство с групповым использованием называется Collide With, а его строка подсказки — collide_with_, последующее свойство collide_with_area будет показано как «Area» внутри раздела «Collide With». Также есть особый случай: когда строка подсказки содержит имя свойства, это свойство также группируется. Это в основном помогает группировать такие свойства, как font, font_color и font_size (используя строку подсказки font_).
Если свойство имеет @GlobalScope.PROPERTY_USAGE_SUBGROUP использование, подгруппа будет создана так же, как и группа, и для каждой подгруппы будет создан раздел второго уровня.
Примечание: В отличие от разделов, созданных из имен свойств, подобных путям, EditorInspector не будет писать имя с заглавной буквы для разделов, созданных из групп. Поэтому свойства с использованием группы обычно используют имена с заглавной буквы вместо имен в стиле snake_case.
Свойства
draw_focus_border |
|
|
focus_mode |
|
|
follow_focus |
|
|
horizontal_scroll_mode |
|
Методы
void |
|
create_default_inspector(filter_line_edit: LineEdit = null) static |
|
void |
|
void |
|
void |
|
get_selected_path() const |
|
instantiate_property_editor(object: Object, type: Variant.Type, path: String, hint: PropertyHint, hint_text: String, usage: int, wide: bool = false) static |
Сигналы
edited_object_changed() 🔗
Генерируется при изменении объекта, редактируемого инспектором.
Вызывается при нажатии кнопки Edit Object в инспекторе. В основном используется в инспекторе дерева удаленной сцены.
property_deleted(property: String) 🔗
Выдается при удалении свойства из инспектора.
property_edited(property: String) 🔗
Выдается при редактировании свойства в инспекторе.
property_keyed(property: String, value: Variant, advance: bool) 🔗
Вызывается, когда свойство задается в инспекторе. Свойства могут быть запрограммированы, нажав на значок «ключ» рядом со свойством, когда панель «Анимация» переключена.
property_selected(property: String) 🔗
Выдается при выборе свойства в инспекторе.
property_toggled(property: String, checked: bool) 🔗
Вызывается при переключении логического свойства в инспекторе.
Примечание: Этот сигнал никогда не вызывается, если включено внутреннее свойство autoclear. Поскольку это свойство всегда включено в инспекторе редактора, этот сигнал никогда не вызывается самим редактором.
resource_selected(resource: Resource, path: String) 🔗
Выдается при выборе ресурса в инспекторе.
restart_requested() 🔗
Выдается, когда свойство, требующее перезапуска для применения, редактируется в инспекторе. Используется только в настройках проекта и настройках редактора.
Описания метода
void collapse_all_folding() 🔗
Складывает все секции.
EditorInspector create_default_inspector(filter_line_edit: LineEdit = null) static 🔗
Создает инспектор с той же конфигурацией, что и в панели инспектора редактора. При передаче LineEdit в filter_line_edit инспектор будет фильтровать свои свойства на основе LineEdit.text всякий раз, когда генерируется LineEdit.text_changed.
Показывает свойства указанного object в этом инспекторе для редактирования. Чтобы очистить инспектор, вызовите этот метод с null.
Примечание: Если вы хотите редактировать объект в главном инспекторе редактора, используйте вместо этого методы edit_* в EditorInterface.
void expand_all_folding() 🔗
Разворачивает все складывающиеся секции.
void expand_revertable() 🔗
Разворачивает только те сворачиваемые разделы, которые содержат обратимое (т.е. не по умолчанию) свойство.
Возвращает объект, выбранный в данный момент в этом инспекторе.
String get_selected_path() const 🔗
Получает путь к текущему выбранному свойству.
EditorProperty instantiate_property_editor(object: Object, type: Variant.Type, path: String, hint: PropertyHint, hint_text: String, usage: int, wide: bool = false) static 🔗
Создает редактор свойств, который может использоваться пользовательским интерфейсом плагина для редактирования указанного свойства object.