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
Eredita: ScrollContainer < Container < Control < CanvasItem < Node < Object
Un controllo per modificare le proprietà di un oggetto.
Descrizione
Questo è il controllo che implementa la modifica delle proprietà nelle finestre Impostazioni, nel pannello Ispettore, ecc. dell'editor. Per utilizzare EditorInspector nel pannello Ispettore dell'editor, usa EditorInterface.get_inspector().
EditorInspector mostrerà le proprietà nello stesso ordine dell'array restituito da Object.get_property_list().
Se il nome di una proprietà è simile a un percorso (ovvero se contiene barre), EditorInspector creerà sezioni nidificate per le "cartelle" lungo il percorso. Ad esempio, se una proprietà si chiama highlighting/gdscript/node_path_color, sarà mostrata come "Node Path Color", dentro la sezione "GDScript", nidificata dentro la sezione "Highlighting".
Se una proprietà ha un uso @GlobalScope.PROPERTY_USAGE_GROUP, raggrupperà le proprietà successive il cui nome inizia con la stringa indicativa della proprietà. Il gruppo termina quando una proprietà non inizia con quella stringa indicativa o quando inizia un nuovo gruppo. Un nome di gruppo vuoto termina il gruppo attuale. EditorInspector creerà una sezione di primo livello per ogni gruppo. Ad esempio, se una proprietà con uso di gruppo ha il nome Collide With e la sua stringa indicativa è collide_with_, una proprietà successiva collide_with_area sarà mostrata come "Area" dentro la sezione "Collide With". Esiste anche un caso speciale: quando la stringa indicativa contiene il nome di una proprietà, anche quella proprietà è raggruppata. Questo serve principalmente per aiutare a raggruppare proprietà come font, font_color e font_size (tramite la stringa indicativa font_).
Se una proprietà ha un uso @GlobalScope.PROPERTY_USAGE_SUBGROUP, un sottogruppo sarà creato allo stesso modo di un gruppo e sarà creata una sezione di secondo livello per ciascun sottogruppo.
Nota: A differenza delle sezioni create da nomi di proprietà simili a percorsi, EditorInspector non userà la maiuscola per i nomi delle sezioni create da gruppi. Pertanto, i nomi delle proprietà con l'uso di gruppo solitamente in maiuscolo anziché in snake_case.
Proprietà
draw_focus_border |
|
|
focus_mode |
|
|
follow_focus |
|
|
horizontal_scroll_mode |
|
Metodi
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 |
Segnali
edited_object_changed() 🔗
Emesso quando l'oggetto modificato dall'ispettore è cambiato.
Emesso quando il pulsante Modifica di un Object è stato premuto nell'ispettore. Viene utilizzato principalmente nell'Ispettore dell'albero di scene remoto.
property_deleted(property: String) 🔗
Emesso quando una proprietà viene rimossa dall'ispettore.
property_edited(property: String) 🔗
Emesso quando una proprietà viene modificata nell'ispettore.
property_keyed(property: String, value: Variant, advance: bool) 🔗
Emesso quando una proprietà viene usata come chiave nell'ispettore. È possibile usare come chiave una proprietà cliccando sull'icona "chiave" accanto a una proprietà quando il pannello Animazione è attivo.
property_selected(property: String) 🔗
Emesso quando una proprietà viene selezionata nell'ispettore.
property_toggled(property: String, checked: bool) 🔗
Emesso quando una proprietà booleana viene commutata nell'ispettore.
Nota: Questo segnale non viene mai emesso se la proprietà interna autoclear è abilitata. Poiché questa proprietà è sempre abilitata nell'ispettore dell'editor, questo segnale non viene mai emesso dall'editor stesso.
resource_selected(resource: Resource, path: String) 🔗
Emesso quando una risorsa viene selezionata nell'ispettore.
restart_requested() 🔗
Emesso quando una proprietà che richiede un riavvio per essere applicata viene modificata nell'ispettore. È utilizzato solo nelle Impostazioni del progetto e nelle Impostazioni dell'editor.
Descrizioni dei metodi
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.
Mostra le proprietà dell'oggetto object in questo ispettore per la modifica. Per cancellare l'ispettore, chiama questo metodo con null.
Nota: Se si desidera modificare un oggetto nell'ispettore principale dell'editor, usa invece i metodi edit_* in 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.
Restituisce l'oggetto attualmente selezionato in questo ispettore.
String get_selected_path() const 🔗
Ottiene il percorso della proprietà attualmente selezionata.
EditorProperty instantiate_property_editor(object: Object, type: Variant.Type, path: String, hint: PropertyHint, hint_text: String, usage: int, wide: bool = false) static 🔗
Crea un editor di proprietà che può essere utilizzato dall'interfaccia utente dell'estensione per modificare la proprietà specificata dell'oggetto object.