GUI API

Материал из iRidium Mobile Wiki
Перейти к: навигация, поиск

ЗАГРУЗИТЬ: Пример проекта

IR.CreateItem

Эта функция используется для создания элементов

Основной Синтаксис: IR.CreateItem(Тип_элемента, Имя_элемента,Координата_X, Координата_Y, Ширина_элемента, Высота_элемента);

  • Тип_элемента - указываем тип элемента, который создаем;
  • Имя_элемента - задаем имя элемента;
  • Координата_Х, Координата_Y - начальная позиция элемента в рабочем поле;
  • Ширина_элемента, Высота_элемента - ширина и высота создаваемого элемента 
IR.AddListener(IR.EVENT_START,0, function() //Событие, которое срабатывает при начале работы приложения
{
IR.CreateItem(IR.ITEM_BUTTON,"Button",30,40,800,150);    //Создание итема
});

При основном синтаксисе создаваемый элемент создается на текущей активной странице. Текущая активная страница определяется IR.CurrentPage. В случае, если вам необходимо создать элемент на странице, которая сейчас скрыта или на всплывающем окне, то вам понадобится использовать следующий синтаксис:

IR.GetItem("Имя_Страницы_или_Попапа").CreateItem(Тип_элемента, Имя_элемента,Координата_X, Координата_Y, Ширина_элемента, Высота_элемента);

  • Имя_Страницы_или_Попапа - любое имя страницы или попапа заранее определенных в проекте. 
IR.AddListener(IR.EVENT_START,0, function() //Событие, которое срабатывает при начале работы приложения
{
IR.GetItem("Popup 1").CreateItem(IR.ITEM_BUTTON,"Button",30,40,800,150);
});

Элементы создаваемые c помощью IR.CreateItem имею фиксированный шрифт cour.ttf, изменить его нельзя, размер шрифта 20.

IR.GetItem

Эта функция используется для изменения элементов

Синтаксис: IR.GetItem("Страница_Размещения_Элемента").GetItem("Имя_Элемента")

  • Страница_Размещения_Элемента - страница с расположенным элемент
  • Имя_Элемента - имя элемента, который редактируем 
IR.AddListener(IR.EVENT_START,0, function() //Событие, которое срабатывает
//при начале работы приложения
{
IR.CreateItem(IR.ITEM_BUTTON,"Button"); //Создание итема

IR.GetItem("Page 1").GetItem("Button").Width = 500; // Изменение ширины итема
 
IR.GetItem("Page 1").GetItem("Button").Height = 100; //Изменение высоты итема
 
IR.GetItem("Page 1").GetItem("Button").X = 0; //Изменение координаты Х у итема
 
IR.GetItem("Page 1").GetItem("Button").Y = 100; //Изменение координаты Y у итема
 
IR.GetItem("Page 1").GetItem("Button").GetState(0).Border = 5; //Изменение типа
//бордюра у итема
 
IR.GetItem("Page 1").GetItem("Button").GetState(0).Text = "This is new items"; 
//Изменение отображаемого текста на итема
 
IR.GetItem("Page 1").GetItem("Button").GetState(0).Opacity = 200;//Изменение 
//прозрачности итема(0-255)
//Изменение отображаемой картинки на итеме
//(Для получения имени картинки воспользуйтесь интеллектуальной подсказкой
//для этого нажмите ctrl+space после команды
//IR.GetItem("Page 1").GetItem("Button").GetState(0).Image =)
IR.GetItem("Page 1").GetItem("Button").GetState(0).Image = "pict.jpg"; 
//Изменение отображаемой иконки на итеме
//(Для получения имени картинки воспользуйтесь 
//интеллектуальной подсказкой
//для этого нажмите ctrl+space после команды 
//IR.GetItem("Page 1").GetItem("Button").GetState(0).Icon =)
IR.GetItem("Page 1").GetItem("Button").GetState(0).Icon = "pict.jpg"; 


//Изменение шрифта текста
// Для изменения шрифта на графическом элементе, введите имя файла шрифта в свойство Font
// Файл шрифта должен быть в проекте, если в проекте нет такого шрифта, шрифт установлен не будет.
IR.GetItem("Page 1").GetItem("Button").GetState(0).Font = "Tahoma.ttf"; 

IR.GetItem("Page 1").GetItem("Button").GetState(0).TextEffect = 1; //Добавление эфектов к шрифту

IR.GetItem("Page 1").GetItem("Button").Visible  = false; // Показать/скрыть элемент (true/false) 

IR.GetItem("Page 1").GetItem("Button").Enable = false; // Активный / не активный элемент (true/false) 
// дублирует свойство Avtive элемента из редактора.

// Для Trigger Button свойства TriggerValue1 и TriggerValue2 для записи и чтения
IR.GetItem("Page 1").GetItem("Item 1").TriggerValue1 = 0
IR.GetItem("Page 1").GetItem("Item 1").TriggerValue2 = 100;
});

IR.DeleteItem

Эта функция используется для удаления графических элементов созданных с помощью функции IR.CreateItem.

Синтаксис: IR.DeleteItem(Идентификатор_элемента) 

IR.AddListener(IR.EVENT_START, 0, function() // Функция запускаемая при старте приложения
{
  // Получаем идентификатор элемента и передаем его в метод DeleteItem
  IR.DeleteItem(IR.GetItem("Page 1").GetItem("Item 1"));
});

ItemsCount

Эта функция используется для подсчета количества элементов на странице

Синтаксис: IR.CurrentPage.ItemsCount

Она возвращает количество элементов на выбранной странице. Полученное число можно сохранить в переменную или отобразить на элементе: 

IR.AddListener(IR.EVENT_START, 0, function() // Функция запускаемая при старте приложения
{
  // Получаем идентификатор элемента на котором высветим число элементов
  var ShowCount = IR.GetItem("Page 1").GetItem("Item 107");
     
  // Получаем число элементов и отображаем
  ShowCount.Text = IR.CurrentPage.ItemsCount;  
});


Также можно подсчитать количество элементов на любой другой доступной странице, заменив:

IR.CurrentPage на IR.GetItem("Имя_Страницы")

  • Имя_Страницы - имя страницы на которой будут подсчитываться элементы 
IR.AddListener(IR.EVENT_START, 0, function() // Функция запускаемая при старте приложения
{
  // Получаем идентификатор элемента на котором высветим число элементов
  var ShowCount = IR.GetItem("Page 1").GetItem("Item 107");
     
  // Получаем число элементов и отображаем
  ShowCount.Text = IR.GetItem("Page 2").ItemsCount;  
});

GetState

Эта функция используется для обращения к состоянию элемента

Синтаксис: IR.GetItem("Имя_страницы").GetItem("Имя_Итема").GetState(Положение_стейта).Свойства;

  • Имя_страницы - указывает команде к какой странице нужно обратиться
  • Имя_Итема - указывает команде к какому итему нужно обратиться
  • Положение_стейта - указывает команде к какому стейту нужно обратиться (отсчет идет с 0)
  • Свойства - указываем свойства для изменения 
IR.AddListener(IR.EVENT_START,0,function() //Событие, которое происходит по старту приложения
{ 
IR.CreateItem(IR.ITEM_BUTTON,"Button")  //Создаем итем

IR.GetItem("Page 1").GetItem("Button").GetState(0).Opacity = 200; //Обращаемся к стейту
//1 и изменяем прозрачность

IR.GetItem("Page 1").GetItem("Button").GetState(1).Opacity = 10;  //Обращаемся к стейту
//2 и изменяем прозрачность

IR.GetItem("Page 1").GetItem("Button").Feedback = 4 //указываем какой способ 
//смены стейтов использовать

});

IR.PagesCount

Эта функция используется для подсчета страниц в проекте

Синтаксис: IR.PagesCount.

Команда возвращает число, его можно к примеру сохранить в переменную: 

IR.AddListener(IR.EVENT_START, 0, function() //Событие, которое срабатывает при начале работы приложения
{
  var count = IR.PagesCount; //Команда для подсчета количества страниц в проекте
});


IR.PopupsCount

Эта функция используется для подсчета количества попапов в проекте

Синтаксис: IR.PopupsCount.

Команда возвращает число, его можно к примеру сохранить в переменную: 

IR.AddListener(IR.EVENT_START, 0, function() //Событие, которое срабатывает при начале работы приложения
{
  var PopupsCount = IR.PopupsCount; //Команда для подсчета количества попапов в проекте
});

IR.CurrentPage

Эта функция используется для получения доступа к открытой в данный момент страницы

Синтаксис: IR.CurrentPage; 

IR.AddListener(IR.EVENT_START, 0, function()  //Событие, которое срабатывает при начале работы приложения
{
  var current = IR.CurrentPage; //Команда записывает идентификатор текущей страницы

  // Для функции IR.CurrentPage также доступно чтение и изменение свойств.

  // Пример 1 - вывод в лог значение Name с помощью прямого обращения к свойству.
   IR.Log(IR.CurrentPage.Name);
   
   // Пример 2 - запись ссылки на текущую страницу в переменную
   // Вызов свойств уже от переменной, этот способ следует использовать
   // если вы планируете использовать множество свойств текущей страницы.
   // Использование ссылки дает выигрыш в производительности.
   var Page = IR.CurrentPage;            
   IR.Log(Page.Name);
   
   // Пример 3 - Прямая запись свойства в переменную.
   var Name = IR.CurrentPage.Name;            
   IR.Log(Name);
});

IR.GetPage

Эта функция используется для обращения к странице

Синтаксис: IR.GetPage(Имя_Страницы_или_идентификатор); 

IR.AddListener(IR.EVENT_START, 0, function()  //Событие, которое срабатывает при начале работы приложения
{
  var MyPage = IR.GetPage("Page 1"); //Обращение к странице по имени
  var MyPage = IR.GetPage(0); //Обращение к странице по идентификатору
});

IR.GetPopup

Эта функция используется для обращения к попапу

Синтаксис: IR.GetPopup(Имя_Попапа_или_идентификатор); 

IR.AddListener(IR.EVENT_START, 0, function()  //Событие, которое срабатывает при начале работы приложения
{
  var MyPopup = IR.GetPopup("Popup 1"); //Обращение к попапу по имени
  var MyPopup = IR.GetPopup(0); //Обращение к попапу по идентификатору
});


IR.ShowPopup

Эта функция используется для открытия попапа

Синтаксис: IR.ShowPopup(Имя_Попапа_или_идентификатор); 

IR.AddListener(IR.EVENT_START, 0, function()  //Событие, которое срабатывает при начале работы приложения
{
  IR.ShowPopup("Popup 1"); //Открытие попапа по имени
});

IR.ShowPage

Эта функция используется для открытия страницы

Синтаксис: IR.ShowPage(Имя_Страницы_или_идентификатор); 

IR.AddListener(IR.EVENT_START, 0, function()  //Событие, которое срабатывает при начале работы приложения
{
  IR.ShowPage("Page 1"); //Открытие страницы по имени
});

IR.HideAllPopups

Эта функция используется для закрытия попапов на конкретной странице или на всех страницах.

Синтаксис: IR.HideAllPopups(Имя_Страницы_или_идентификатор);
Если Имя_Страницы_или_идентификатор не указан, попапы скрываются на всех страницах. 

IR.AddListener(IR.EVENT_START, 0, function()  //Событие, которое срабатывает при начале работы приложения
{
  IR.HideAllPopups("Page 1"); //Закрытие попапов на странице Page 1
});

IR.HidePopup

Эта функция используется для закрытия попапа

Синтаксис: IR.HidePopup(Имя_Попапа_или_идентификатор); 

IR.AddListener(IR.EVENT_START, 0, function()  //Событие, которое срабатывает при начале работы приложения
{
  IR.HidePopup("Popup 1"); //Закрытие попапа по имени
});

IR.EVENT_ITEM_PRESS

Событие срабатывает при нажатии на элемент

Синтаксис: IR.AddListener(IR.EVENT_ITEM_PRESS,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_ITEM_PRESS,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие сработает при нажатии на элемент Item 1, который расположен на странице Page 1
{
  IR.HidePopup("Popup 1"); //Закрытие попапа по имени
});

IR.EVENT_ITEM_HOLD

Событие срабатывает при удержании элемента

Синтаксис: IR.AddListener(IR.EVENT_ITEM_HOLD,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_ITEM_HOLD,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие сработает при удержании элемента Item 1, который расположен на странице Page 1
{
  IR.HidePopup("Popup 1"); //Закрытие попапа по имени
});

IR.EVENT_ITEM_RELEASE

Событие срабатывает при отжатии на элемент

Синтаксис: IR.AddListener(IR.EVENT_ITEM_RELEASE,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_ITEM_RELEASE,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие сработает при отжатии на элемент Item 1, который расположен на странице Page 1
{
  IR.HidePopup("Popup 1"); //Закрытие попапа по имени
});

IR.EVENT_ITEM_CHANGE

Событие срабатывает при изменении элемента EditBox

Синтаксис: IR.AddListener(IR.EVENT_ITEM_CHANGE,Обращение_К_Элементу,function(text) 

IR.AddListener(IR.EVENT_ITEM_CHANGE,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие сработает при изменении элемента EditBox с именем Item 1,который расположен
//на странице Page 1
{
  IR.Log(IR.GetItem("Page 1").GetItem("Item 1").text); //Вывод в консоль текста из элемента EditBox
});

IR.EVENT_MOUSE_DOWN

Событие срабатывает при зажатии кнопки мыши(Работает только на Windows)

Синтаксис: IR.AddListener(IR.EVENT_MOUSE_DOWN,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_MOUSE_DOWN,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие сработает при зажатии кнопки мыши на элементе Item 1, расположенном
//на странице Page 1
{
  IR.Log("The mouse is down");//Вывод в консоль сообщения
});


IR.EVENT_MOUSE_UP

Событие срабатывает при отжатии кнопки мыши(Работает только на Windows)

Синтаксис: IR.AddListener(IR.EVENT_MOUSE_UP,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_MOUSE_UP,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие сработает при отжатии кнопки мыши на элементе Item 1, расположенном
//на странице Page 1
{
  IR.Log("The mouse is up");//Вывод в консоль сообщения
});

IR.EVENT_MOUSE_MOVE

Событие срабатывает если зажать кнопку мыши на элементе и перемещать мышь(Работает только на Windows)

Синтаксис: IR.AddListener(IR.EVENT_MOUSE_MOVE,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_MOUSE_MOVE,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие срабатывает если зажать кнопку мыши на элементе и перемещать мышь
{
  IR.Log("The mouse moveing");//Вывод в консоль сообщения
});


IR.EVENT_TOUCH_DOWN

Событие срабатывает при зажатии пальцем на элементе(Работает только на iOS и Android)

Синтаксис: IR.AddListener(IR.EVENT_TOUCH_DOWN,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_TOUCH_DOWN,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие сработает при зажатии пальцем элемента Item 1, расположенном
//на странице Page 1
{
  IR.Log("touch down");//Вывод в консоль сообщения
});


IR.EVENT_TOUCH_UP

Событие срабатывает при отжатии пальцем(Работает только на iOS и Android)

Синтаксис: IR.AddListener(IR.EVENT_TOUCH_UP,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_TOUCH_UP,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие сработает при отжатии пальцем на элементе Item 1, расположенном
//на странице Page 1
{
  IR.Log("touch up");//Вывод в консоль сообщения
});

IR.EVENT_TOUCH_MOVE

Событие срабатывает движении пальца на элементе(Работает только на iOS и Android)

Синтаксис: IR.AddListener(IR.EVENT_TOUCH_MOVE,Обращение_К_Элементу,function() 

IR.AddListener(IR.EVENT_MOUSE_MOVE,IR.GetItem("Page 1").GetItem("Item 1"),function()
//Событие срабатывает движении пальца на элементе
{
  IR.Log("touch move");//Вывод в консоль сообщения
});

IR.EVENT_ITEM_SHOW

Событие срабатывает при появлении страницы или попапа.

Синтаксис: IR.AddListener(IR.EVENT_ITEM_SHOW,Обращение_К_Странице_или_Попапу,function() 

IR.AddListener(IR.EVENT_ITEM_SHOW,IR.GetItem("Popup 1"),function()
//Событие срабатывает при появлении страницы или попапа.
{
  IR.Log("Popup 1 Show");//Вывод в консоль сообщения
});

IR.EVENT_ITEM_HIDE

Событие срабатывает при скрытии страницы или попапа.

Синтаксис: IR.AddListener(IR.EVENT_ITEM_HIDE,Обращение_К_Странице_или_Попапу,function() 

IR.AddListener(IR.EVENT_ITEM_HIDE,IR.GetItem("Popup 1"),function()
//Событие срабатывает при скрытии страницы или попапа.
{
  IR.Log("Popup 1 Hide");//Вывод в консоль сообщения
});

ЗАГРУЗИТЬ: Пример проекта

Источник — «http://wiki2.iridiummobile.ru/index.php?title=GUI_API&oldid=9158»