Динамичный интерфейс

Как упоминалось в уроках ранее, объект описания интерфейса можно изменять, пока интерфейс открыт и изменения тут же будут отображаться в интерфейсе. Больше всего это подходит для элементов, которые должны появляться/изменяться/исчезать только в каких-то определенных условиях (например кнопка, которая появляется, только если в слоте есть предмет)

Получение объекта описания

По скольку интерфейс всегда открывается для контейнера, то контейнер имеет метод получения объекта описания интерфейса для динамичного изменения. Этот метод - getGuiContent() - упоминался в прошлой главе и теперь будет разобран подробнее.

 

Формат объекта описания можно посмотреть в предыущих главах, там же говорится, что динамичными (т.е. изменения которых тут же отобразятся в интерфейсе), являются только части, отвечающие за фон и за элементы - drawing и elements, но не параметры самого интерфейса (заголовок, размер и т.п)

 

И так, предположим мы получили объект описания:

var content = container.getGuiContent();

 

Теперь, чтобы изменить в нем фон, мы можем просто присвоить drawing новое значение:

content.drawing = [

     {type: "background", color: android.graphics.Color.RED}

] // мы удалили все прошлые команды и теперь рисуем просто красный фон

 

С элементами все несколько иначе, чтобы что-то сделать с элементом, нужно обратиться к нему по его имени: content.elements["имя элемента"], после чего с ним можно сделать 3 разных действия:

 

1. Приравнять новому элементу - если элемент с данным именем уже существовал, то старый будет полностью заменен на новый, если элемента не было, то будет просто создан новый элемент

2. Изменить какое-то значение - элемент  с данным именем будет изменен потому что какой то его параметр был изменен.

3. Приравнять null - элемент с данным именем будет удален

 

ПРИМЕР #1: (изменение параметров)

// код ниже при старте откроет интерфейс с 1 кнопкой, при нажатии на которую она будет перемещаться вниз

var testUIScreen = new UI.StandartWindow({

     standart: {

          header: {

               text: {

                    text: "TEST UI"

               }

          },

          inventory: {

               standart: true

          },

          background: {

               standart: true

          }

     },

     drawing: [],

     elements: {

          "test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button

                    onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью

                         var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен

                         content.elements["test_button"].y += 10; // немного сдвигаем кнопку вниз, добавляя 10 к координате y

                    }

               }

          }

     }

});

// открыть интерфейс

UI.testUI(testUIScreen);

 

ПРИМЕР #2: (удаление и создание)

// после нажатия на кнопку, удаляет ее и создает текст о том, что она удалена

var testUIScreen = new UI.StandartWindow({

     standart: {

          header: {

               text: {

                    text: "TEST UI"

               }

          },

          inventory: {

               standart: true

          },

          background: {

               standart: true

          }

     },

     drawing: [],

     elements: {

          "test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button

                    onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью

                         var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен

                         content.elements["test_button"] = null; // удаляем кнопку

                         content.elements["new_element"] = {type: "text", text: "button removed", x: 400, y: 50, width: 200, height: 50}; // создаем текст о том, что она удалена

                    }

               }

          }

     }

});

// открыть интерфейс

UI.testUI(testUIScreen);

 

ПРИМЕР #3: (полная замена + изменение фона)

// после нажатия на кнопку, удаляет ее и создает текст о том, что она удалена, а так же делает фон красным

var testUIScreen = new UI.StandartWindow({

     standart: {

          header: {

               text: {

                    text: "TEST UI"

               }

          },

          inventory: {

               standart: true

          },

          background: {

               standart: true

          }

     },

     drawing: [],

     elements: {

          "test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button

                    onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью

                         var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен

                         content.elements["test_button"] = {type: "text", text: "button removed", x: 400, y: 50, width: 200, height: 50}; // заменяем элемент кнопки на текст о том, что она удалена

                         content.drawing = [

                              {type: "background", color: android.graphics.Color.RED}

                         ]; // мы удалили все прошлые команды и теперь рисуем просто красный фон

                    }

               }

          }

     }

});

// открыть интерфейс

UI.testUI(testUIScreen);

 

ПРИМЕР #4: (tile entity):

// добавляет tile entity интерфейс с кнопкой, которая медленно опускается, пока интерфейс открыт

var testUIScreen = new UI.StandartWindow({

     standart: {

          header: {

               text: {

                    text: "TEST UI"

               }

          },

          inventory: {

               standart: true

          },

          background: {

               standart: true

          }

     },

     drawing: [],

     elements: {

          "test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button

                    onClick: function(container){/* ничего не делаем при клике */}

               }

          }

     }

});


Прототип tile entity:

{

     // ...

     getGuiScreen: function(){ // функция получения интерфейса - отдаем наш интерфейс

          return testUIScreen;

     },

    

     tick: function(){

          var content = this.container.getGuiContent(); // пытаемся получить объект описания

          if (content){ // если получить удалось

               content.elements["test_button"].y += .3; // медленно сдвигаем кнопку вниз

          }

     }

     // ...

}