godot-docs-l10n/classes/uk/class_instanceplaceholder.rst

: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** під час запуску гри, це не замінить вузол у редакторі. Це дозволяє відкласти фактичне завантаження сцени до виклику методу ``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>`

Зателефонуйте цей метод, щоб фактично завантажити в вузол. Створена вершина буде розміщена в якості муфти *above* **InstancePlaceholder** в ялинку. Довідник ``Нод`` також повертається для зручності.

\ **Примітка:** ``методик створення_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>`

Gets the path to the :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 (Значення не повертається.)`