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.

Свойства

bool

draw_focus_border

true (overrides ScrollContainer)

FocusMode

focus_mode

2 (overrides Control)

bool

follow_focus

true (overrides ScrollContainer)

ScrollMode

horizontal_scroll_mode

0 (overrides ScrollContainer)

Методы

void

edit(object: Object)

Object

get_edited_object()

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


Сигналы

edited_object_changed() 🔗

Генерируется при изменении объекта, редактируемого инспектором.


object_id_selected(id: int) 🔗

Вызывается при нажатии кнопки 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 edit(object: Object) 🔗

Показывает свойства указанного object в этом инспекторе для редактирования. Чтобы очистить инспектор, вызовите этот метод с null.

Примечание: Если вы хотите редактировать объект в главном инспекторе редактора, используйте вместо этого методы edit_* в EditorInterface.


Object get_edited_object() 🔗

Возвращает объект, выбранный в данный момент в этом инспекторе.


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.