InstancePlaceholder¶

继承： Item < Object

描述¶

在编辑器中为实例化场景打开选项Load As Placehold会导致它在运行应用时被替换为InstancePlaceholder，这不会替换编辑器中的节点。这使得在调用create_instance()之前延迟实际加载场景成为可能。这对于通过选择性加载部分场景来避免一次加载大型场景非常有用。

InstancePlaceholder没有转换。这会导致任何子节点相对于点（0,0）的Viewport定位，而不是编辑器中显示的它们的父节点。用带有转换的场景替换占位符将再次将子节点相对于其父节点进行转换。

方法¶

Item	create_instance(replace: bool = false, custom_scene: PackedScene = null)
String	get_instance_path() const
Dictionary	get_stored_values(with_order: bool = false)

方法说明¶

Item create_instance(replace: bool = false, custom_scene: PackedScene = null) 🔗

调用此方法以实际加载到节点中。创建的节点将作为兄弟节点放置在场景树中的InstancePlaceholder上方。为了方便起见，还返回了Item的引用。

注意：create_instance()不是线程安全的。如果从线程调用，请使用Object.call_deferred()。

String get_instance_path() const 🔗

获取调用create_instance()时默认加载的PackedScene资源文件的路径。不是线程安全的。如果从线程调用，请使用Object.call_deferred()。

Dictionary get_stored_values(with_order: bool = false) 🔗

返回调用create_instance()时将应用于节点的属性列表。

如果with_order为true，则将一个名为. order（注意前导句点）的键添加到字典中。此.order键是String属性名称的Array，指定应用属性的顺序（索引0是第一个）。