Редактирование:Контейнеры

<div class="mw-parser-output"><p>Контейнер - это объект, позволяющий хранить предметы в слотах, осуществлять операции с ними и так же обладающий методами для интеграции с любым интерфейсом, который открыт для этого контейнера. Произвольный контейнер может быть открыт как любой интерфейс, при этом он будет привязан ко всем слотам интерфейса.
</p><p>&#160;
</p><p>Каждый объект tile entity в мире по умолчанию обладает контейнером, который автоматически сохраняется и для которого открывается интерфейс, отданый при выполнении события getGuiScreen. Подробнее об этом в уроке по tile entity и ниже.
</p><p>&#160;
</p><p>Все специальные контейнеры, такие как инвентарь игрока или сундука наследуют все методы базового контейнера.
</p><p>&#160;
</p>
<h3> Методы </h3>
<p>Создание нового контейнера:
</p>
<pre>var container = new UI.Container();</pre>
<p>&#160;
</p><p>Обращение к встроенному контейнеру внутри tile entity: this.container
</p><p>&#160;
</p>
<h3> Работа со слотами </h3>
<ul><li>getSlot("имя слота") - возвращает объект слота с данным именем, если такого слота нет, создает пустой слот на этом имени и возвращает его. Слот это объект вида {id: id предмета, count: кол-во предмета, data: data предмета}. К слотам интерфейса привязываются слоты с такими же именами, как и у элементов этих слотов в интерфейсе. </li></ul>
<p>&#160;
</p><p>Пример:
</p>
<pre>//интерфейс tile entity задается так:

{

     // ...

     elements: {

          // ...

          &quot;test_slot&quot;: {type: &quot;slot&quot;, x: 400, y: 400, size: 100} // самый обычный слот с именем test_slot

     }

}</pre>
<p>&#160;
</p><p>А прототип tile entity имеет событие клика предметом по нему:
</p>
<pre>{

     // ...

    

     click: function(id, count, data, coords){

          var slot = this.container.getSlot(&quot;test_slot&quot;); // получаем объект слота, который привязан к слоту test_slot в интерфейсе

          slot.id = id; slot.count = count; slot.data = data; // устанавливаем в слот тот предмет, которым тапнули по блоку tile entity

          return false;

     }

}</pre>
<p>&#160;
</p><p>Таким образом каждый раз, когда мы будем тапать предметом по блоку данного tile entity, то в слоте test_slot будет лежать тот же самый предмет, что и в руке.
</p><p>&#160;
</p>
<ul><li>setSlot("имя слота", id, кол-во, data) - устанавливает переданный предмет в слот с данным именем. Краткая запись того, что было показано в примере. </li>
<li>clearSlot("имя слота") - очищает слот с данным именем </li>
<li>validateSlot("имя слота") - если кол-во или id предмета нулевое или отрицательное, очищает слот. Быстрое исправление некорректных значений слота (пустой слот с кол-вом больше 0, предмет существует, однако его кол-во 0) </li>
<li>validateAll() - вызывает метод validateSlot для всех слотов </li>
<li>dropAt(x, y, z) - очищает контейнер и дропает все, что содержалось в нем на данных координатах ввиде предметов </li>
<li>refreshSlots() - ничего не делает в стандартном контейнере, для контейнеров инвентаря блоков и мобов обновляет данные о слотах в контейнере </li>
<li>applyChanges() - ничего не делает в стандартном контейнере, для контейнеров инвентаря блоков и мобов сохраняет изменения, которые были произведены на контейнере </li></ul>
<p>&#160;
</p><p>&#160;
</p>
<h3> Работа с интерфейсом </h3>
<ul><li>openAs(объект интерфейса любого типа) - открывает данный объект интерфейса и привязывается к нему </li>
<li>isOpened() - возвращает, открыт ли этот контейнер для какого-то интерфейса </li>
<li>close() - если открыт для какого-то интерфейса, закрывает его </li>
<li>getGuiContent() - если открыт для какого-то интерфейса, возвращает объект описания данного интерфейса, который можно изменять для динамичного изменения интерфейса. Не работает, если контейнер открыт для группы окон. </li>
<li>getGuiScreen()&#160; - если открыт для какого-то интерфейса, возвращает объект этого интерфейса. </li>
<li>getElement("имя элемента") - если в интерфейсе, для которого открыт данный контейнер, есть элемент с данным именем возвращает его. ВНИМАНИЕ! Это не тот объект элемента, который задается в объекте описания! </li>
<li>requireElement("имя элемента", "тип элемента") - аналогичен getElement, но если элемент имеет тип, отличающийся от данного, то вернет null. </li>
<li>setScale("имя элемента шкалы", заполненность 0-1) - если шкала с данным именем существует, устанавливает ее значение на данное, при этом 0 - пустая шкала, 1 - полная </li>
<li>setScaleAsLiquid("имя элемента шкалы", строковый id жидкости, заполненность 0-1) - если шкала с данным именем существует, устанавливает ее, как шкалу жидкости, меняя текстуру на текстуру жидкости с данным строковым id, при этом размер шкалы не меняется. </li>
<li>setText("имя элемента текста", строка) - если элемент текста с данным именем существует, меняет его содержание на переданную строку </li>
<li>setTextSize("имя элемента текста", размер) - если элемент текста с данным именем существует, меняет его размер </li>
<li>setTextColor("имя элемента текста", цвет) - если элемент текста с данным именем существует, меняет его цвет </li>
<li>setTextShadow("имя элемента текста", значение тени) - если элемент текста с данным именем существует, меняет его тень</li></ul>
</div>
@@ Строка 1: / Строка 1: @@
 Контейнер - это объект, позволяющий хранить предметы в слотах, осуществлять операции с ними и так же обладающий методами для интеграции с любым интерфейсом, который открыт для этого контейнера. Произвольный контейнер может быть открыт как любой интерфейс, при этом он будет привязан ко всем слотам интерфейса.
+&nbsp;
 Каждый объект tile entity в мире по умолчанию обладает контейнером, который автоматически сохраняется и для которого открывается интерфейс, отданый при выполнении события getGuiScreen. Подробнее об этом в уроке по tile entity и ниже.
+&nbsp;
 Все специальные контейнеры, такие как инвентарь игрока или сундука наследуют все методы базового контейнера.
+&nbsp;
 === Методы ===
 Создание нового контейнера:
-<pre>var container = new UI.Container();
+<pre>var container = new UI.Container();</pre>
-</pre>
+&nbsp;
 Обращение к встроенному контейнеру внутри tile entity: this.container
+&nbsp;
 === Работа со слотами ===
+*getSlot("имя слота") - возвращает объект слота с данным именем, если такого слота нет, создает пустой слот на этом имени и возвращает его. Слот это объект вида {id: id предмета, count: кол-во предмета, data: data предмета}. К слотам интерфейса привязываются слоты с такими же именами, как и у элементов этих слотов в интерфейсе.
+&nbsp;
 Пример:
@@ Строка 31: / Строка 44: @@
       }
-}
+}</pre>
-</pre>
+&nbsp;
 А прототип tile entity имеет событие клика предметом по нему:
@@ Строка 53: / Строка 67: @@
 }</pre>
-<br/> Таким образом каждый раз, когда мы будем тапать предметом по блоку данного tile entity, то в слоте test_slot будет лежать тот же самый предмет, что и в руке.
+&nbsp;
+Таким образом каждый раз, когда мы будем тапать предметом по блоку данного tile entity, то в слоте test_slot будет лежать тот же самый предмет, что и в руке.
-=== Работа с контейнером ===
+&nbsp;
-*getSlot("имя слота") - возвращает объект слота с данным именем, если такого слота нет, создает пустой слот на этом имени и возвращает его. Слот это объект вида {id: id предмета, count: кол-во предмета, data: data предмета}. К слотам интерфейса привязываются слоты с такими же именами, как и у элементов этих слотов в интерфейсе.
 *setSlot("имя слота", id, кол-во, data) - устанавливает переданный предмет в слот с данным именем. Краткая запись того, что было показано в примере.
 *clearSlot("имя слота") - очищает слот с данным именем
@@ Строка 65: / Строка 80: @@
 *refreshSlots() - ничего не делает в стандартном контейнере, для контейнеров инвентаря блоков и мобов обновляет данные о слотах в контейнере
 *applyChanges() - ничего не делает в стандартном контейнере, для контейнеров инвентаря блоков и мобов сохраняет изменения, которые были произведены на контейнере
+&nbsp;
+&nbsp;
+=== Работа с интерфейсом ===
 *openAs(объект интерфейса любого типа) - открывает данный объект интерфейса и привязывается к нему
 *isOpened() - возвращает, открыт ли этот контейнер для какого-то интерфейса