mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
91 lines
7.6 KiB
ReStructuredText
91 lines
7.6 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_InstancePlaceholder:
|
||
|
||
InstancePlaceholder
|
||
===================
|
||
|
||
**Наследует:** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
||
|
||
Заполнитель для корневого :ref:`Node<class_Node>` :ref:`PackedScene<class_PackedScene>`.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
Включение параметра **Загрузить как плейсхолдер** для созданной сцены в редакторе приводит к её замене на **InstancePlaceholder** при запуске игры, но не заменяет узел в редакторе. Это позволяет отложить фактическую загрузку сцены до вызова :ref:`create_instance()<class_InstancePlaceholder_method_create_instance>`. Это полезно, чтобы избежать одновременной загрузки больших сцен, загружая их по частям.
|
||
|
||
\ **Примечание:** Как и :ref:`Node<class_Node>`, **InstancePlaceholder** не имеет преобразования. Это приводит к тому, что все дочерние узлы располагаются относительно начала координат :ref:`Viewport<class_Viewport>`, а не относительно их родительских узлов, как отображается в редакторе. Замена плейсхолдера на сцену с преобразованием снова преобразует дочерние узлы относительно их родительских узлов.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Методы
|
||
------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`Node<class_Node>` | :ref:`create_instance<class_InstancePlaceholder_method_create_instance>`\ (\ replace\: :ref:`bool<class_bool>` = false, custom_scene\: :ref:`PackedScene<class_PackedScene>` = null\ ) |
|
||
+-------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`String<class_String>` | :ref:`get_instance_path<class_InstancePlaceholder_method_get_instance_path>`\ (\ ) |const| |
|
||
+-------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_stored_values<class_InstancePlaceholder_method_get_stored_values>`\ (\ with_order\: :ref:`bool<class_bool>` = false\ ) |
|
||
+-------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания метода
|
||
------------------------------
|
||
|
||
.. _class_InstancePlaceholder_method_create_instance:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`Node<class_Node>` **create_instance**\ (\ replace\: :ref:`bool<class_bool>` = false, custom_scene\: :ref:`PackedScene<class_PackedScene>` = null\ ) :ref:`🔗<class_InstancePlaceholder_method_create_instance>`
|
||
|
||
Вызовите этот метод для фактической загрузки узла. Созданный узел будет помещен как родственный *выше* **InstancePlaceholder** в дереве сцены. Ссылка на :ref:`Node<class_Node>` также возвращается для удобства.
|
||
|
||
\ **Примечание:** :ref:`create_instance()<class_InstancePlaceholder_method_create_instance>` не является потокобезопасным. Используйте :ref:`Object.call_deferred()<class_Object_method_call_deferred>` при вызове из потока.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_InstancePlaceholder_method_get_instance_path:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`String<class_String>` **get_instance_path**\ (\ ) |const| :ref:`🔗<class_InstancePlaceholder_method_get_instance_path>`
|
||
|
||
Получает путь к файлу ресурсов :ref:`PackedScene<class_PackedScene>`, который загружается по умолчанию при вызове :ref:`create_instance()<class_InstancePlaceholder_method_create_instance>`. Не потоко-безопасно. Используйте :ref:`Object.call_deferred()<class_Object_method_call_deferred>` при вызове из потока.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_InstancePlaceholder_method_get_stored_values:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`Dictionary<class_Dictionary>` **get_stored_values**\ (\ with_order\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_InstancePlaceholder_method_get_stored_values>`
|
||
|
||
Возвращает список свойств, которые будут применены к узлу при вызове :ref:`create_instance()<class_InstancePlaceholder_method_create_instance>`.
|
||
|
||
Если ``with_order`` равен ``true``, ключ с именем ``.order`` (обратите внимание на начальную точку) добавляется в словарь. Этот ключ ``.order`` представляет собой :ref:`Array<class_Array>` имен свойств :ref:`String<class_String>`, определяющих порядок, в котором будут применены свойства (индекс 0 является первым).
|
||
|
||
.. |virtual| replace:: :abbr:`virtual (Этот метод обычно должен быть переопределен пользователем, чтобы иметь какой-либо эффект.)`
|
||
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
||
.. |const| replace:: :abbr:`const (Этот метод не имеет побочных эффектов. Он не изменяет ни одну из переменных-членов экземпляра.)`
|
||
.. |vararg| replace:: :abbr:`vararg (Этот метод принимает любое количество аргументов после описанных здесь.)`
|
||
.. |constructor| replace:: :abbr:`constructor (Этот метод используется для создания типа.)`
|
||
.. |static| replace:: :abbr:`static (Этот метод не нуждается в вызове экземпляра, поэтому его можно вызвать напрямую, используя имя класса.)`
|
||
.. |operator| replace:: :abbr:`operator (Этот метод описывает допустимый оператор для использования с этим типом в качестве левого операнда.)`
|
||
.. |bitfield| replace:: :abbr:`BitField (Это значение является целым числом, составленным как битовая маска следующих флагов.)`
|
||
.. |void| replace:: :abbr:`void (Нет возвращаемого значения.)`
|