• Справочник
• Страницы и элементы

Методы

Объект IR - глобальный объект, содержащий в себе все функции и константы API iRidium. Методы объекта IR для графического интерфейса позволяют обратиться к страницам и попапам интерфейса визуализации, а также выполнить команды, связанные с работой операционной системы.

Цепочка команд, примененных к объекту IR, позволяет получить доступ к любому объекту интерфейса, использовать его методы и обращаться к свойствам. Иерархия объектов: IR > Page / Popup > Item > State.

IR.CreateItem()​

создать графический элемент на текущей странице проекта.Страница может быть определена при обращении к свойству CurrentPage объекта IR. Чтобы создать элемент на произвольной странице, нужно применить метод CreateItem к ссылке на объект Page или Popup, полученной с помощью метода IR.GetItem().

Синтаксис

IR.CreateItem([item_type](#ircreateitem), [name](#ircreateitem), [X](#ircreateitem), [Y](#ircreateitem), [width](#ircreateitem), [height](#ircreateitem));

Пример

IR.AddListener(IR.EVENT_START,0, function()
{
var src = IR.CreateItem(IR.ITEM_BUTTON,"Button 1",30,40,800,150);
IR.Log(src) // [Object DialogItemPrototype]
});

Примечания

var src = IR.GetItem("Page 1").CreateItem(IR.ITEM_BUTTON,"Button 1",30,40,800,150);
IR.Log(src) // [Object DialogItemPrototype]

IR.DeleteItem()​

удалить Popup или диалоговый элемент. Страницу удалить нельзя.

Синтаксис

IR.DeleteItem([popup](#irdeleteitem))

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.DeleteItem(IR.GetItem("Page 1").GetItem("Popup 1"));
});

Примечания

var item = IR.GetItem("Page 1").GetItem("Item 1");
IR.DeleteItem(item);

IR.GetPage()​

получить доступ к странице проекта (Page). Имея доступ к странице, вы можете обратиться к элементам на этой странице с помощью метода .GetItem().

Синтаксис

IR.GetPage([page](#getpage))

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetPage("Page 1");
});

Примечания

var Item = IR.GetPage("Page 1").GetItem("Item 1");
IR.Log(Item); //    [object DialogItemPrototype]

IR.GetPopup()​

получить доступ к попапу проекта (Popup). Имея доступ к попапу, вы можете обратиться к элементам на этом попапе с помощью метода .GetItem().

Синтаксис

IR.GetPopup([popup](#irgetpopup))

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetPopup("Popup 1");
});

Примечания

var Item = IR.GetItem("Popup 1").GetItem("Item 1");
IR.Log(Item); //    [object DialogItemPrototype]

IR.ShowPage()​

показать страницу по имени (Page)

Синтаксис

IR.ShowPage([page](#irshowpage))

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.ShowPage("Page 1");
});

Примечания

IR.ShowPopup()​

показать попап по имени (Popup)

Синтаксис

IR.ShowPopup([popup](#irshowpopup), )

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.ShowPopup("Popup 1");
});

Примечания

IR.HidePopup()​

скрыть попап по имени (Popup)

Синтаксис

IR.HidePopup([[#IR.HidePopup()|popup](#ircreateeffect), )

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.HidePopup("Popup 1");
});

Примечания

IR.HideGroup()​

скрыть группу попапов по имени группы. Из группы может быть открыт только один попап - именно он закроется при вызове метода. Имена групп см. в меню "Manage Popup Groups".

Синтаксис

IR.HideGroup([[#IR.HideGroup()|group](#ircreateeffect))

Пример

function hide_1 ()
{
IR.HideGroup("Popup Group 1");
}

Примечания

IR.TogglePopup()​

показать Popup, если он скрыт, и скрыть, если показан

Синтаксис

IR.TogglePopup([popup](#irtogglepopup), )

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.TogglePopup("Popup 1");
});

Примечания

IR.HideAllPopups()​

скрыть все попапы (Popup) на указанной странице

Синтаксис

IR.HideAllPopups([[#IR.HideAllPopups()|page,](#ircreateeffect))

Пример

IR.AddListener(IR.EVENT_ITEM_PRESS,IR.GetPage("Page 1").GetItem("Item 2"), function()
{
IR.HideAllPopups("Page 1", <1>);
});

Примечания

IR.CreateEffect()​

создать эффект анимации во время работы приложения и использовать его при показе и скрытии попапа.

Синтаксис

IR.CreateEffect([effect](#ircreateeffect));

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var Fade = IR.CreateEffect(IR.EFFECT_FADE); // <translate><!--T:170-->
создаем группу, сохраняем в переменную</translate>
Fade.Group = 1000; // <translate><!--T:171-->
присваиваем номер группы</translate>
Fade.Delay = 0; // <translate><!--T:172-->
задержка выполнения эффектов</translate>
Fade.Duration = 400; // <translate><!--T:173-->
продолжительность эффекта</translate>
Fade.Tween = 0; // <translate><!--T:174-->
формула вычисления эффекта (твинер)</translate>
IR.ShowPopup("Popup 1", 1000); // <translate><!--T:175-->
покажем попап с эффектами группы 1000 </translate>
});

Примечания

IR.ShowKeyboard()​

показать системную клавиатуру iOS или Android устройства

Синтаксис

IR.ShowKeyboard([type](#irshowkeyboard))

Пример

IR.AddListener(IR.EVENT_ITEM_PRESS, IR.GetItem("Page 1").GetItem("Item 1"), function()
{
IR.ShowKeyboard(2);
});

Примечания

IR.PasteFromClipboard()​

Вставить текст из буфера обмена в активный Editbox. Текст будет вставлен только если в буфере действительно находится Текст (а не изображение или др. контент). Курсор позиционируется после вставленного текста

Синтаксис

IR.PasteFromClipboard()

Пример

IR.AddListener(IR.EVENT_ITEM_PRESS, IR.GetItem("Page 1").GetItem("Paste Button"),function()
{
IR.PasteFromClipboard();
});

Примечания

IR.GetClipboard()​

Получить текст из буфера обмена

Синтаксис

IR.GetClipboard()

Пример

`var clipboard = IR.GetClipboard();`

Примечания

IR.ShowPasteHelper()​

над курсором в активном EditBox этот метод отобразит нативное, масштабируемое в соответствии с разрешением проекта всплывающее окно: "PasteHelper" c надписью Paste, аналогично инструменту вставки на iOS и Android устройствах. По нажатию на это всплывающее окно, выполяется команда IR.PasteFromClipboard();. Нажатие на окно вставки, повторное нажатие на поле ввода или смена фокуса сразу закрывают PasteHelper

Синтаксис

IR.ShowPasteHelper()

Пример

IR.AddListener(IR.EVENT_ITEM_HOLD, IR.GetItem("Page 1").GetItem("EditBox"),function()
{
IR.ShowPasteHelper();
});

Примечания

IR.SelectNextEditBox()​

сместить фокус с текущего поля ввода на следующее по списку. Для определения порядка полей ввода используется Z-позиция элементов, посмотреть которую можно, включив отображение элементов в дереве проекта (Tools > Options > Show > Show Items In Tree). По нажатию Tab (на Windows) фокус смещается на следующее поле ввода автоматически, в пределах страницы или окна

Синтаксис

IR.SelectNextEditBox();

Пример

IR.AddListener(IR.EVENT_ITEM_CHANGE, IR.GetItem("Page 1").GetItem("Item 1"), function (action, key)
{
if (action == 2)  // press Enter
{
IR.SelectNextEditBox();
}
});

IR.SetLifeTime()​

установить время (в миллисекундах), в течение которого будет отображаться попап. Если необходимо сделать так, чтобы попап появлялся на определенное время, можно обратиться к его свойству LifeTime, с помощью метода .SetLifeTime().

Синтаксис

IR.SetLifeTime(popup, lt)

Пример

function set_lt()
{
IR.SetLifeTime("Popup 1", 5000);
IR.ShowPopup("Popup 1");
}

IR.GetItem()​

получить доступ к странице или попапу. Имея доступ к странице или попапу, вы можете обратиться к элементам на них с помощью метода .GetItem().

Синтаксис

IR.GetItem([item](#irgetitem))

Пример

IR.AddListener(IR.EVENT_START,0, function()
{
var DialogItem = IR.GetItem("Popup 1");
IR.Log(DialogItem); //  [object DialogItemPrototype]
});

Примечания

var Item = IR.GetItem("Popup 1").GetItem("Item 1");
IR.Log(Item); //    [object DialogItemPrototype]

.GetItem()​

получить доступ к графическому элементу на странице или попапе.

Синтаксис

IR.GetItem([page](#getitem)).GetItem([item](#getitem));

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var DialogItem = IR.GetItem("Page 2").GetItem("Item 2");
IR.Log(DialogItem) // [Object DialogItemPrototype]
});

Примечания

.CreateItem()​

создает графический элемент на странице или попапе

Синтаксис

IR.GetItem([page](#createitem)).CreateItem([item_type](#createitem), [name](#createitem), [X](#createitem), [Y](#createitem), [width](#createitem), [height](#createitem));

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Page 2").CreateItem(IR.ITEM_BUTTON, "Button 1", 30, 40, 800, 150);
});

Примечания

.Clone()​

клонирует страницу, попап, графический элемент на странице или попапе

Синтаксис

IR.GetItem([page](#clone)).Clone([new_page_name](#clone));
<br />
IR.GetItem([page](#clone)).GetItem([item](#clone)).Clone([new_item_name](#clone));
```<br/>

| **на входе** | **значение** | **описание** |
| --- | --- | --- |
| page | "Page 1" | type: String <br/> имя страницы или попапа |
| new_page_name | "Page 2" | type: String <br/> имя новой страницы или попапа (клона) |
| item | "Item 1" | type: String <br/> имя графического элемента |
| new_item_name | "Item 2" | type: String <br/> имя нового графического элемента (клона) |

| **на выходе** | | |
| --- | --- | --- |
| Object | [Object DialogItemPrototype] | type: Object <br/> ссылка на объект |

**Пример**

```js
IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Page 1").Clone("Page 2");
IR.GetItem("Page 1").GetItem("Item 1").Clone("Item 2");
// result:
IR.Log(IR.GetItem("Page 2")) // [object DialogItemPrototype]
IR.Log(IR.GetItem("Page 1").GetItem("Item 2")) // [object DialogItemPrototype]
});

.GetPopup()​

получает по индексу попап, показанный на странице. Индекс - номер показанного попапа от 0 до n, возвращает null, если нет попапа с таким индексом.

Синтаксис

IR.GetItem([page](#getpopup)).GetPopup([index](#getpopup));

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var DialogItem = IR.GetItem("Page 1").GetPopup(0);
IR.Log(DialogItem) // [Object DialogItemPrototype]
});

Примечания

.StartActions()​

выполнить действия, привязанные к событию графического элемента

Синтаксис

IR.GetItem([page](#startactions)).GetItem([item](#startactions)).StartActions([event](#startactions));

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Page 1").GetItem("Item 1").StartActions(IR.EVENT_ITEM_PRESS);
});

Примечания

.GetState()​

получить состояние графического элемента как объект

Синтаксис

IR.GetItem([page](#getstate)).GetItem([item](#getstate)).GetState([state_index](#getstate));

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var DialogItem = IR.GetItem("Page 1").GetItem("Item 1").GetState(0);
IR.Log(DialogItem); // [object StatePrototype]
});

Примечания

.CreateState()​

добавить состояние графическому элементу

Синтаксис

IR.GetItem([page](#createstate)).GetItem([item](#createstate)).CreateState();

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Page 1").GetItem("Item 1").CreateState();
});

Примечания

.ShowPopup()​

показать попап на странице

Синтаксис

IR.GetItem([page](#showpopup)).ShowPopup([popup](#showpopup), );

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Page 1").ShowPopup("Popup 1");
});

.HidePopup()​

скрыть попап на странице

Синтаксис

IR.GetItem([[#.HidePopup()|page](#ircreateeffect)).HidePopup([popup](#hidepopup), );

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Page 1").HidePopup("Popup 1");
});

.TogglePopup()​

скрыть попап, если он показан, показать, если скрыт

Синтаксис

IR.GetItem([[#.TogglePopup()|page](#ircreateeffect)).TogglePopup([popup](#togglepopup), );

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Page 1").TogglePopup("Popup 1");
});

.Show()​

показать графический элемент или попап на странице (универсальный метод)

Синтаксис

IR.GetItem([[#.Show()|popup](#ircreateeffect)).Show();

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Popup 1").Show();
});

.Hide()​

скрыть графический элемент или попап на странице (универсальный метод)

Синтаксис

IR.GetItem([page](#hide)).Hide();

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
IR.GetItem("Page 1").Hide();
});

События

Событие - процесс, проброшенный в скрипты и имеющий идентификатор для отслеживания.

Слушатель - это функция, которая выполняется в случае срабатывания указанного ей события

Добавьте слушатель с помощью метода IR.AddListener

IR.AddListener(event, input, action);

• event - идентификатор события, за которым следит слушатель
• input - входной параметр, необходимый для создания слушателя. Если параметра нет, укажите 0
• action - не именованная функция или ссылка на объявленную функцию, внутри которой выполняются действия
• pointer - указатель на контекст вызова слушателя (не обязательный). Обратиться к контексту можно с помощью оператора this. Контекст может меняться во время работы программы

Пример:

IR.AddListener(IR.EVENT_ITEM_PRESS, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
    IR.Log("pressed!");
});

IR.EVENT_ITEM_PRESS​

идентификатор события, которое срабатывает при нажатии на графический элемент

Синтаксис

IR.AddListener(IR.EVENT_ITEM_PRESS, [item](#irevent_item_press), [function](#irevent_item_press), [pointer](/SWDL/dev-iridi/[#irevent-item-press)]);

Пример

IR.AddListener(IR.EVENT_ITEM_PRESS, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_ITEM_RELEASE​

идентификатор события, которое срабатывает при отпускании графического элемента

Синтаксис

IR.AddListener(IR.EVENT_ITEM_RELEASE, [item](#irevent_item_release), [function](#irevent_item_release), [pointer](/SWDL/dev-iridi/[#irevent-item-release)]);

Пример

IR.AddListener(IR.EVENT_ITEM_RELEASE, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_ITEM_HOLD​

идентификатор события, которое срабатывает при удержании графического элемента

Синтаксис

IR.AddListener(IR.EVENT_ITEM_HOLD, [item](#irevent_item_hold), [function](#irevent_item_hold), [pointer](/SWDL/dev-iridi/[#irevent-item-hold)]);

Пример

IR.AddListener(IR.EVENT_ITEM_HOLD, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_ITEM_END_HOLD​

идентификатор события, которое срабатывает в конце удержания графического элемента (при отпускании, после события HOLD)

Синтаксис

IR.AddListener(IR.EVENT_ITEM_END_HOLD, [item](#irevent_item_end_hold), [function](#irevent_item_end_hold), [pointer](/SWDL/dev-iridi/[#irevent-item-end-hold)]);

Пример

IR.AddListener(IR.EVENT_ITEM_END_HOLD, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_ITEM_LOST_FOCUS​

идентификатор события, которое срабатывает при отпускании любого объекта интерфейса (вместе с Release или End Of Hold). Событие указывает на потерю элементом фокуса

Синтаксис

IR.AddListener(IR.EVENT_ITEM_LOST_FOCUS, [item](#irevent_item_lost_focus), [function](#irevent_item_lost_focus), [pointer](/SWDL/dev-iridi/[#irevent-item-lost-focus)]);

Пример

IR.AddListener(IR.EVENT_ITEM_LOST_FOCUS, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_ITEM_CHANGE​

идентификатор события, которое срабатывает при вводе текста в EditBox. С его помощью можно различать ввод символа и отправку команды, такой как Del или Enter. Событие возвращает: action - идентификатор действия:

0 - NONE				11 - NEXT							22 - BANK_2_MOMENTARY_SELECT
1 - INSERT_TEXT			12 - PREVIOUS						23 - BANK_3_MOMENTARY_SELECT
2 - ENTER				13 - HOME							24 - BANK_4_MOMENTARY_SELECT
3 - UP					14 - END							25 - BANK_5_MOMENTARY_SELECT
4 - DOWN				15 - INSERT							26 - PAGE_UP
5 - LEFT				16 - BANK_1_LOCKING_SELECT			27 - PAGE_DOWN
6 - RIGHT				17 - BANK_2_LOCKING_SELECT			28 - FUNCTION
7 - DELETE				18 - BANK_3_LOCKING_SELECT			29 - CTRL
8 - CLEAR				19 - BANK_4_LOCKING_SELECT			30 - ALT
9 - ABORT				20 - BANK_5_LOCKING_SELECT			31 - SCANCODE
10 - EXIT				21 - BANK_1_MOMENTARY_SELECT

key - идентификатор клавиши, дающий наиболее точное представление о действии.
Например: action : 30 (ALT), key : 56 (LEFT ALT), 90 (RIGHT ALT)

0 - NONE = 0		26 - BRACKET_LEFT		52 - PERIOD				78 - KEYPAD_ADD
1 - ESCAPE			27 - BRACKET_RIGHT		53 - SLASH				79 - KEYPAD_1
2 - 1				28 - RETURN				54 - SHIFT_RIGHT		80 - KEYPAD_2
3 - 2				29 - CONTROL_LEFT		55 - KEYPAD_MULTIPLY	81 - KEYPAD_3
4 - 3				30 - A					56 - ALT_LEFT			82 - KEYPAD_0
5 - 4				31 - S					57 - SPACE				83 - KEYPAD_PERIOD
6 - 5				32 - D					58 - CAPS_LOCK			84 - F11
7 - 6				33 - F					59 - F1					85 - F12
8 - 7				34 - G					60 - F2					86 - KEYPAD_ENTER
9 - 8				35 - H					61 - F3					87 - CONTROL_RIGHT
10 - 9				36 - J					62 - F4					88 - KEYPAD_DIVIDE
11 - 0				37 - K					63 - F5					89 - PRINT_SCREEN
12 - MINUS			38 - L					64 - F6					90 - ALT_RIGHT
13 - EQUAL			39 - SEMICOLON			65 - F7					91 - HOME
14 - BACKSPACE		40 - APOSTROPHE			66 - F8					92 - UP
15 - TAB			41 - GRAVE				67 - F9					93 - PAGE_UP
16 - Q				42 - SHIFT_LEFT			68 - F10				94 - LEFT
17 - W				43 - BACKSLASH			69 - KEYPAD_NUM_LOCK	95 - RIGHT
18 - E				44 - Z					70 - SCOLL_LOCK			96 - END
19 - R				45 - X					71 - KEYPAD_7			97 - DOWN
20 - T				46 - C					72 - KEYPAD_8			98 - PAGE_DOWN
21 - Y				47 - V					73 - KEYPAD_9			99 - INSERT
22 - U				48 - B					74 - KEYPAD_SUBTRACT	100 - DELETE
23 - I				49 - N					75 - KEYPAD_4			101 - PAUSE
24 - O				50 - M					76 - KEYPAD_5			102 - WINDOWS_LEFT
25 - P				51 - COMMA				77 - KEYPAD_6			103 - WINDOWS_RIGHT

Синтаксис

IR.AddListener(IR.EVENT_ITEM_CHANGE, [item](#irevent_item_change), [function](#irevent_item_change) (action, key) {}, [pointer](/SWDL/dev-iridi/[#irevent-item-change)]);

Пример

IR.AddListener(IR.EVENT_ITEM_CHANGE, IR.GetItem("Page 1").GetItem("Item 1"), function (action, key)
{
if (action == 1)  // insert text
{
IR.Log("new string: " + IR.GetItem("Page 1").GetItem("Item 1").Text)
}
});

IR.EVENT_MOUSE_DOWN​

идентификатор события, которое срабатывает при нажатии кнопки мыши (Windows)

Синтаксис

IR.AddListener(IR.EVENT_MOUSE_DOWN, [item](#irevent_mouse_down), [function](#irevent_mouse_down), [pointer](/SWDL/dev-iridi/#irevent-item-press));

Пример

IR.AddListener(IR.EVENT_MOUSE_DOWN, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_MOUSE_UP​

идентификатор события, которое срабатывает при отжатии кнопки мыши (Windows)

Синтаксис

IR.AddListener(IR.EVENT_MOUSE_UP, [item](#irevent_mouse_up), [function](#irevent_mouse_up), [pointer](/SWDL/dev-iridi/#irevent-item-press));

Пример

IR.AddListener(IR.EVENT_MOUSE_UP, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_MOUSE_MOVE​

идентификатор события, которое срабатывает при перетягивании курсора мыши с зажатой левой кнопкой (Windows). Отдает каждое изменение координат курсора до момента, пока левая кнопка не будет отпущена.

Синтаксис

IR.AddListener(IR.EVENT_MOUSE_MOVE, [item](#irevent_mouse_move), [function](#irevent_mouse_move), [pointer](/SWDL/dev-iridi/[#irevent-item-press)]);

Пример

IR.AddListener(IR.EVENT_MOUSE_MOVE, IR.GetItem("Page 1").GetItem("Item 1"), function (x, y)
{
IR.Log(x + ":" + y); // new coordinates on move
});

IR.EVENT_TOUCH_DOWN​

идентификатор события, которое срабатывает при нажатии на элемент (iOS, Android)

Синтаксис

IR.AddListener(IR.EVENT_TOUCH_DOWN, [item](#irevent_touch_down), [function (x, y, id)](#irevent_touch_down), [pointer](/SWDL/dev-iridi/[#irevent-item-press)]);

Пример

IR.AddListener(IR.EVENT_TOUCH_DOWN, IR.GetItem("Page 1").GetItem("Item 1"), function (x, y, id)
{
IR.Log(x + " " + y + " " + id);
});

IR.EVENT_TOUCH_UP​

идентификатор события, которое срабатывает при отпускании элемента (iOS, Android)

Синтаксис

IR.AddListener(IR.EVENT_TOUCH_UP, [item](#irevent_touch_up), [function (x, y, id)](#irevent_touch_up), [pointer](/SWDL/dev-iridi/[#irevent-item-press)]);

Пример

IR.AddListener(IR.EVENT_TOUCH_UP, IR.GetItem("Page 1").GetItem("Item 1"), function (x, y, id)
{
IR.Log(x + " " + y + " " + id);
});

IR.EVENT_TOUCH_MOVE​

идентификатор события, которое срабатывает при перемещении пальца по элементу (iOS, Android)

Синтаксис

IR.AddListener(IR.EVENT_TOUCH_MOVE, [item](#irevent_touch_move), [function](#irevent_touch_move), [pointer](/SWDL/dev-iridi/[#irevent-item-press)]);

Пример

IR.AddListener(IR.EVENT_TOUCH_MOVE, IR.GetItem("Page 1").GetItem("Item 1"), function ()
{
IR.Log(x + ":" + y); // new coordinates on move
});

IR.EVENT_ITEM_SHOW​

идентификатор события, которое срабатывает при показе страницы или попапа

Синтаксис

IR.AddListener(IR.EVENT_ITEM_SHOW, [item](#irevent_item_show), [function](#irevent_item_show), [pointer](/SWDL/dev-iridi/[#irevent-item-press)]);

Пример

IR.AddListener(IR.EVENT_ITEM_SHOW, IR.GetItem("Page 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_ITEM_HIDE​

идентификатор события, которое срабатывает при скрытии страницы или попапа

Синтаксис

IR.AddListener(IR.EVENT_ITEM_HIDE, [item](#irevent_item_hide), [function](#irevent_item_hide), [pointer](/SWDL/dev-iridi/[#irevent-item-press)]);

Пример

IR.AddListener(IR.EVENT_ITEM_HIDE, IR.GetItem("Page 1"), function ()
{
IR.Log("action"); // action
});

IR.EVENT_POPUP_ITEM_CHANGE​

идентификатор события, которое срабатывает при выполнении любого действия у элементов попапа

Синтаксис

IR.AddListener(IR.EVENT_POPUP_ITEM_CHANGE, [item](#irevent_popup_item_change), [function (event, popup, item)](#irevent_popup_item_change), [pointer](/SWDL/dev-iridi/[#irevent-item-press)]);

Пример

IR.AddListener(IR.EVENT_POPUP_ITEM_CHANGE,IR.GetPopup("Popup 1"),function(event, popup, item){
IR.Log(event); // идетификатор события, например 142-Press, 143-Release, 146-Hold
IR.Log(popup.Name); // имя Popup
IR.Log(item.Name); // имя элемента
});

Свойства объектов

Свойство объекта - одна из характеристик объекта, доступная для обращения. Набор свойств зависит от типа объекта. Объекты, полученные при обращении к нижележащим объектам иерархии, не наследуют их свойств (например, обратившись к объекту Item нельзя получить ширину объекта Popup, на котором он расположен).

IR​

IR.[property](#ir)

|ProjectName|"Welcome"|String|имя проекта, который сейчас открыт в приложении |PagesCount|4|Number|число страниц в проекте |PopupsCount|12|Number|число попапов в проекте |CurrentPage|[object DialogItemPrototype]|Object|ссылка на объект - открытую страницу проекта

Page​

IR.GetItem(page).[property](#page)

|ItemsCount|53|Number|отдает число элементов на странице |PopupsCount|2|Number|отдает число попапов на странице |PopupsOnPage|Array of Objects|Array|отдает массив объектов - попапов на странице |X|100|Number|координата по горизонтали |Y|100|Number|кооридната по вертикали |Width|250|Number|ширина |Height|400|Number|высота |Name|"Item 1"|String|имя объекта |Type|IR.ITEM_BUTTON|Object|тип объекта |BlurDepth|50|Number|глубина эффекта размытия (Blur) |BlurEnabled|true|Boolean|активация эффекта размытия. Эффект действует только на изображение страницы, на элементы, размещенные на странице, эффект не действует.

Popup​

IR.GetItem(popup).[property](#popup)

|ItemsCount|53|Number|отдает число элементов на попапе |Modal|0 / 1|Number|свойство модальности попапа |X|100|Number|координата по горизонтали |Y|100|Number|кооридната по вертикали |Width|250|Number|ширина |Height|400|Number|высота |Name|"Item 1"|String|имя объекта |Type|IR.ITEM_BUTTON|Object|тип объекта |Angle|360|Number|угол поворота |Parent|"Page 1"|String|родительский объект |BlurDepth|50|Number|глубина эффекта размытия (Blur) |BlurEnabled|true|Boolean|активация эффекта размытия. Эффект действует только на изображение попапа, на элементы, размещенные на попапе, эффект не действует.

Item​

IR.GetItem(page/popup).GetItem(item).[property](#item)

|Text|"Hello"|String|текст во всех состояниях элемента |State|2|Number|установить состояние элемента, Feefback: Channel |Feedback|4|Number|установить тип обратной связи элемента. Для Button: 0 - None, 1 - Channel, 2 - InvertChannel, 3 - On, 4 - Momentary, 5 - Blink. Для других элементов см. порядок свойств в Studio |Hit|2|Number|установить реакцию на нажатия. Для Button: 0 - Active Touch, 1 - Bounding Box, 2 - Pass Through, 3 - Touch on Fill. Для других элементов см. порядок свойств в Studio |Password|0|Number|установить номер пароля, 0 - без пароля, 1-4 - один из паролей |Value|1|Number|установить значение Value элемента |StatesCount|1|Number|количество состояний элемента |X|100|Number|координата элемента по горизонтали |Y|100|Number|кооридната элемента по вертикали |Width|250|Number|ширина элемента |Height|400|Number|высота элемента |Name|"Item 1"|String|имя элемента |Type|IR.ITEM_BUTTON|Object|тип элемента |Angle|360|Number|угол поворота элемента относительно центральной оси |ScaleX|100|Number|коэффициент растяжения Image по оси по Х |ScaleY|100|Number|коэффициент растяжения Image по оси по Y |Visible|true|Boolean|показать/скрыть элемент |Enable|true|Boolean|возможность нажать на елемент. false - элемент отображается в оттенках серого, нажать на него нельзя |Parent|"Page 1"|String|родительский объект - страница или окно, на которой расположен элемент, страница, на которой открыто окно |PasswordChar|"\u2022"|String|символ, на который будет визуально заменен любой текст, введенный в EditBox. Используется для скрытия введенных паролей. Получить исходный текст можно из свойства .Text |zIndex|1|Number|Порядок по оси Z (Z-Order)

Item: Level​

IR.GetItem(page/popup).GetItem(level).[property](#item:-level)

|Min|0|Number|нижний предел уровня |Max|100|Number|верхний предел уровня |Empty|0 / 1|Number|заполненность уровня:
1 - значение уровня равно 0,
0 - значение уровня не равно 0 |Filled|0 / 1|Number|заполненность уровня:
1 - значение уровня равно максимальному значению,
0 - значение уровня не равно максимальному значению |Invert|0 / 1|Number|инвертировать шкалу уровня |Direction|0 / 1|Number| вертикальный/горизонтальный уровень |Slider|1|Number|тип ползунка, от 0 до N, см. порядковый номер ползунка в Studio |SliderColor|0xFF0000FF|RGBA|цвет ползунка

Item: Multistate Level​

IR.GetItem(page/popup).GetItem(MS_level).[property](#item:-multistate-level)

|Min|0|Number|нижний предел уровня |Max|100|Number|верхний предел уровня |Empty|0 / 1|Number|заполненность уровня:
1 - значение уровня равно 0,
0 - значение уровня не равно 0 |Filled|0 / 1|Number|заполненность уровня:
1 - значение уровня равно максимальному значению,
0 - значение уровня не равно максимальному значению |Invert|0 / 1|Number|инвертировать шкалу уровня |Direction|0 / 1|Number| вертикальный/горизонтальный уровень

Item: Joystick​

IR.GetItem(page/popup).GetItem(Joystick).[property](#item:-joystick)

|ValueX|50|Number|значение Value по оси X |ValueY|100|Number|значение Value по оси Y |Color (PickColor, ColorPicker)|0xD2D2D2D2|RGBA| цвет под курсором джойстика |Min|0|Number|нижний предел джойстика |Max|100|Number|верхний предел джойстика |Cursor|1|Number|тип курсора джойстика, от 0 до N, см. порядковый номер курсора в Studio |CursorColor|0xFF0000FF|RGBA|цвет курсора |GetColorOnCoordinates(x,y)|0xB2B2B2FF|RGBA|получить цвет пикселя по его координатам x и y |MinX / MinY|50|Number|минимальная координата по оси X / Y |MaxX / MaxY|100|Number|максимальная координата по оси X / Y

Item: Up/Down Button​

IR.GetItem(page/popup).GetItem(Up/Down_Button).[property](#item:-updown-button)

|Max|100|Number|предел приращения Up/Down Button |Delta|1|Number|шаг приращения |PressDelta|1|Number|шаг приращения при нажатии |HoldDelta|5|Number|шаг приращения при удержании

Item: Trigger Button​

IR.GetItem(page/popup).GetItem(Trigger_Button).[property](#item:-trigger-button)

|TriggerValue1|0|Number|первое значение триггера |TriggerValue2|1|Number|второе значение триггера

Item: List​

IR.GetItem(page/popup).GetItem(list).[property](#state)

|Template|"Popup 1"|string|позволяет установить или запросить шаблон для пунктов списка, которым является один из попапов проекта |Direction|0|number|позволяет установить или запросить направление прокрутки списка:* 0 - вертикальный список* 1 - горизонтальный список |ItemsCount|24|number|позволяет запросить количество пунктов списка |Filter|"A"|string|позволяет отфильтровать пункты списка по их имени (части имени)

см. подробнее в JavaScript API iRIdium. Списки

State​

IR.GetItem(page/popup).GetItem(item).GetState(n).[property](#state)

|Color|0xFF0000FF|RGBA|получить цвет состояния |FillColor|0xFF0000FF|RGBA|установить цвет состояния |ColorAlphaChannel|0xFF0000FF|RGBA|получить прозрачность цвета |Opacity|255|Number|0-255 прозрачность состояния |Border|1|Number|указать тип бордюра от 0 до N, см. порядковый номер бордюра в Studio |BorderColor|0xFF0000FF|RGBA|установить цвет бордюра |TextColor|0xFF0000FF|RGBA|установить цвет текста |Text|"string"|String|текст в состоянии элемента |TextAlign|0|Number|способ выравнивания текста |TextEffectColor|0xFF0000FF|RGBA|установить цвет эффекта |TextPaddingTop|0|Number|смещение текста по Y вверх, для TextAlign: Absolute |TextPaddingLeft|0|Number|смещение текста по X влево, для TextAlign: Absolute |TextPaddingRight|0|Number|смещение текста по X вправо, для TextAlign: Absolute |TextPaddingBottom|0|Number|смещение текста по Y вниз, для TextAlign: Absolute |Image|"Image 1.png"|String|установить изображение по имени. Для динамического изображения используйте имя без расширения |ImageX|0|Number|смещение изображения по X, для ImageAlign: Absolute |ImageY|0|Number|смещение изображения по Y, для ImageAlign: Absolute |ImageAlign|0|Number|способ выравнивания изображения |ImageStretch|0|Number|способ масштабирования 0 - None; 1 - Proportional; 2 - FullSize |ImagePaddingTop|0|Number|смещение изображения по Y вверх, для ImageAlign: Absolute |ImagePaddingLeft|0|Number|смещение изображения по X влево, для ImageAlign: Absolute |ImagePaddingRight|0|Number|смещение изображения по X вправо, для ImageAlign: Absolute |ImagePaddingBottom|0|Number|смещение изображения по Y вниз, для ImageAlign: Absolute |Icon|"Image 2.png"|String|установить изображение-иконку по имени |IconX|0|Number|смещение иконки по X, для IconAlign: Absolute |IconY|0|Number|смещение иконки по Y, для IconAlign: Absolute |IconAlign|0|Number|способ выравнивания иконки |IconPaddingTop|0|Number|смещение иконки по Y вверх, для IconAlign: Absolute |IconPaddingLeft|0|Number|смещение иконки по X влево, для IconAlign: Absolute |IconPaddingRight|0|Number|смещение иконки по X вправо, для IconAlign: Absolute |IconPaddingBottom|0|Number|смещение иконки по Y вниз, для IconAlign: Absolute |IconStrech|0|Number|способ масштабирования 0 - None; 1 - Proportional; 2 - FullSize |Chameleon|"Image 3.png"|String|установить изображение-хамелеон по имени |ChameleonStrech|0|Number|способ масштабирования 0 - None; 1 - Proportional; 2 - FullSize |FontId|1001|Number|установить шрифт по его идентификатору пример |FontFile|“string”|String|Шрифт текста |FontSize|12|Number|Получить размер шрифта |Spacing|0|Number|Получить межбуквенный интервал |LineSpacing|1|Number|Получить межстрочный интервал |TextAlign|0|Number|способ выравнивания текста |TextX|0|Number|смещение текста по X, для TextAlign: Absolute |TextY|0|Number|смещение текста по Y, для TextAlign: Absolute |TextEffect|1|Number|включить эффект текста, от 0 до N, см. порядковый номер эффекта в Studio |TextRotation|0, 90, 180, 270|Number|определяет угол поворота текста внутри элемента.
Подробнее по ссылке. |DrawOrder|0x34521|HEX number|Последовательность отрисовки слоев графического элемента.Каждое число означает слой. Верхний слой - первое число, нижний - последнее. Стандартная последовательность слоев: 0x34521 * 3 - Icon (иконка)* 4 - Text (текст)* 5 - Border (бордюр)* 2 - Image (картинка)* 1 - Fill (заливка)
Например, отобразить текст поверх иконки: 0x43521 |WordWrap|0 / 1|Number|включить автоперенос текста |BlurType|0|Number|Размытие заднего фона
0 - Default; 1 – Background |BlurDepth|100|Number|Величина размытия
0-100