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
Контроль використовується для редагування властивостей об'єкта.
Опис
Це елемент керування, який реалізує редагування властивостей у діалогових вікнах налаштувань редактора, док-станції Inspector тощо. Щоб використовувати EditorInspector у док-станції Inspector редактора, використовуйте EditorInterface.get_inspector().
EditorInspector покаже властивості в тому ж порядку, що й масив, повернутий Object.get_property_list().
Якщо ім’я властивості схоже на шлях (тобто якщо воно містить косі риски), EditorInspector створить вкладені розділи для «каталогів» уздовж шляху. Наприклад, якщо властивість має назву highlighting/gdscript/node_path_color, вона буде показана як «Колір шляху до вузла» всередині розділу «GDScript», вкладеного в розділ «Виділення».
Якщо властивість має постійне використання PROPERTY_USAGE_GROUP, вона групуватиме наступні властивості, назва яких починається з рядка підказки властивості. Група закінчується, коли властивість не починається з цього рядка підказки або коли починається нова група. Порожня назва групи фактично завершує поточну групу. EditorInspector створить розділ верхнього рівня для кожної групи. Наприклад, якщо властивість із груповим використанням має назву Collide With, а її підказка — collide_with_, наступна властивість collide_with_area буде показана як " Область» всередині розділу «Зіткнутися з». Існує також окремий випадок: коли рядок підказки містить назву властивості, ця властивість також групується. Це в основному для того, щоб допомогти згрупувати такі властивості, як шрифт, колір_шрифту і розмір_шрифту (використовуючи рядок підказки шрифт_).
Якщо властивість використовує @GlobalScope.PROPERTY_USAGE_SUBGROUP, підгрупа буде створена так само, як і група, і для кожної підгрупи буде створено розділ другого рівня.
Примітка: На відміну від розділів, створених із імен властивостей, схожих на шляхи, EditorInspector не буде писати назву з великої літери для розділів, створених із груп. Тому властивості з груповим використанням зазвичай використовують імена, написані великими літерами, замість імен snake_cased.
Властивості
draw_focus_border |
|
|
focus_mode |
|
|
follow_focus |
|
|
ScrollMode |
horizontal_scroll_mode |
|
Методи
void |
|
create_default_inspector(filter_line_edit: LineEdit = null) static |
|
void |
edit(object: Object) |
void |
|
void |
|
Object |
|
String |
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() 🔗
Увімкнено, коли об’єкт, який редагував інспектор.
Увімкнено, коли кнопка редагування 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) 🔗
Випробувано, коли в інспекторі знаходиться об’єкт boolean.
Примітка: Цей сигнал ніколи не вдається, якщо ввімкнено внутрішню autoclear. Оскільки ця властивість завжди включена в інспектор редактора, цей сигнал ніколи не видається самим редактором.
resource_selected(resource: Resource, path: String) 🔗
Увімкнено, коли обраний ресурс в інспекторі.
restart_requested() 🔗
Випробувано, коли в інспекторі редаговано майно, яке вимагає перезавантаження. Це тільки використовується в налаштуваннях проекту та налаштуваннях редактора.
Описи методів
void collapse_all_folding() 🔗
Collapses all foldable sections.
EditorInspector create_default_inspector(filter_line_edit: LineEdit = null) static 🔗
Creates an inspector with the same configuration as the one used in the editor's Inspector dock. When passing a LineEdit into filter_line_edit, the inspector will filter its properties based on LineEdit.text whenever LineEdit.text_changed is emitted.
void edit(object: Object) 🔗
Показує властивості даного object у цьому інспекторі для редагування. Щоб очистити інспектор, викличте цей метод за допомогою null.
Примітка: Якщо ви хочете редагувати об’єкт у головному інспекторі редактора, замість цього використовуйте методи edit_* в EditorInterface.
void expand_all_folding() 🔗
Expands all foldable sections.
void expand_revertable() 🔗
Expands only the foldable sections that contain a revertable (i.e. non-default) property.
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.