• Справочник
• Списки

методы, события и свойства для работы с динамическими списками, которые можно заполнять в процессе работы приложения

События​

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

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

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

IR.AddListener(event, input, action);

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

IR.EVENT_ITEM_SELECT​

идентификатор события, которое срабатывает при нажатии на пункт списка. Получите ссылку на объект List с помощью метода IR.GetItem().

Синтаксис

IR.AddListener(IR.EVENT_ITEM_SELECT, list, function, [pointer]);

Пример

IR.AddListener(IR.EVENT_ITEM_SELECT, IR.GetItem("Page 1").GetItem("List 1"), function(itemID, subItemID, index) {
IR.Log("pressed "+itemID+" / "+subItemID);
});

IR.EVENT_LIST_ITEM_CHANGE​

идентификатор события, которое срабатывает при нажатии, отпускании, сдвиге списка (Press, Release и Move). Событие предоставляет доступ на чтение и запись ко всем свойствам подэлемента, что существенно расширяет возможности списков. Получите ссылку на объект List с помощью метода IR.GetItem().

Синтаксис

IR.AddListener(IR.EVENT_LIST_ITEM_CHANGE, list, function, [pointer]);

Пример

IR.AddListener(IR.EVENT_LIST_ITEM_CHANGE, list, function(itemID, subItemID, event_type, object, index) {
IR.Log("itemID " + itemID + ", subItemID " + subItemID + ", index " + index + ", object " + object.Name);
switch(event_type)
{
case IR.EVENT_LIST_ITEM_PRESS:
{
IR.Log("Pressed");
break;
}
case IR.EVENT_LIST_ITEM_RELEASE:
{
IR.Log("Relesed");
break;
}
case IR.EVENT_LIST_ITEM_MOVE:
{
IR.Log("Move");
break;
}
case IR.EVENT_LIST_ITEM_HOLD:
{
IR.Log("Hold");
break;
}
case IR.EVENT_LIST_ITEM_END_HOLD:
{
IR.Log("End Hold");
break;
}
}
});

IR.EVENT_LIST_SCROLL​

идентификатор события, которое срабатывает при нажатии, отпускании, сдвиге списка (Press, Release и Move). Событие предоставляет информацию о текущем положении списка, направлении листания и факте достижения крайнего положения (начала или конца) списка.

Синтаксис

IR.AddListener(IR.EVENT_LIST_SCROLL, list, function, [pointer]);

Пример

var list = IR.GetItem("Page 1").GetItem("List 1");
IR.AddListener(IR.EVENT_LIST_SCROLL, list, function(in_position, in_direction, in_edge) {
IR.Log("POSITION " + in_position);
IR.Log("DIRECTION " + in_direction);
IR.Log("EDGE " + in_edge + "\n");
});

IR.ITEM_LISTBOX (List)​

Методы, используемые при работе с динамическими списками: графическими элементами типа List.

IR.CreateItem()​

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

Синтаксис

IR.CreateItem(IR.ITEM_LISTBOX, name, X, Y, width, height);

Пример

IR.AddListener(IR.EVENT_START,0, function()
{
var src = IR.CreateItem(IR.ITEM_LISTBOX,"List 1",30,40,200,500);
IR.Log(src); // [Object DialogItemPrototype]
});

var list_1 = IR.GetItem("Page 1").CreateItem(IR.ITEM_LISTBOX,"List 1",30,40,200,500);
IR.Log(list_1) // [Object DialogItemPrototype]  // create list and get the link in one action

.CreateItem()​

создать новый пункт элемента List. Чтобы создать пункт списка, нужно получить ссылку на объект List с помощью метода IR.GetItem().

Синтаксис

list.CreateItem(item, subitem, {property: value, ...});

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var List_1 = IR.GetItem("Page 1").GetItem("List 1");
List_1.CreateItem(0, 1, {Text: "Hello"});
});

.DeleteItem()​

удалить пункт элемента List. Для этого нужно получить ссылку на объект List с помощью метода IR.GetItem().

Синтаксис

list.DeleteItem(item);

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var List = IR.GetItem("Page 1").GetItem("List 1");
List.DeleteItem(0); // delete first point of list
});

.Clear()​

удалить все пункты элемента List. Для этого нужно получить ссылку на объект List с помощью метода IR.GetItem().

Синтаксис

list.Clear();

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var List = IR.GetItem("Page 1").GetItem("List 1");
List.Clear(); // clear list
});

.SetPosition()​

пролистать список до указанной позиции. Для этого нужно получить ссылку на объект List с помощью метода IR.GetItem().

Синтаксис

list.SetPosition(item);

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var List = IR.GetItem("Page 1").GetItem("List 1");
List.SetPosition(12); // go to point
});

.SetStrictPositionByIndex()​

пролистать список до указанной позиции. Для этого нужно получить ссылку на объект List с помощью метода IR.GetItem().

Синтаксис

list.SetStrictPositionByIndex(item);

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var List = IR.GetItem("Page 1").GetItem("List 1");
List.SetStrictPositionByIndex(12); // go to point
});

Свойства​

Свойства списков - графических элементов типа List:

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

var list = IR.GetItem("Page 1").GetItem("List 1");
//** Template **//
IR.Log(list.Template); // "Popup 1"
list.Template = "Popup 2"; // change template if exist
//** Direction **//
IR.Log(list.Direction); // 1
list.Direction = 0;  // change direction
//** ItemsCount **//
IR.Log(list.ItemsCount); // 24
//** Filter **//
list.CreateItem(0, 0, {Text: "Curriculum", Name:"Curriculum"});
list.CreateItem(1, 0, {Text: "Privacy", Name: "Privacy"});  
list.Filter = "C"; // "Privacy" will be filtered out, "Curriculum" showed
IR.Log(list.Filter); // "C"
//** ScrollEnabled **//
list.ScrollEnabled = true; // list can be flipped manually
list.ScrollEnabled = false; // list cannot be flipped manually

IR.ITEM_GOOD_LIST​

Методы, используемые при работе с динамическими списками: графическими элементами типа Good List. Good List - новая версия элемента Listbox с лучшими возможностями для отображения большого количества пунктов.

IR.CreateItem()​

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

Синтаксис

IR.CreateItem(IR.ITEM_GOOD_LIST, name, X, Y, width, height, infinity);

Пример

IR.AddListener(IR.EVENT_START,0, function()
{
var GList = IR.CreateItem(IR.ITEM_GOOD_LIST, "GList 1", 20, 20, 250, 600, false);
IR.Log(GList) // [Object DialogItemPrototype]
});

var list_1 = IR.GetItem("Page 1").CreateItem(IR.ITEM_GOOD_LIST, "GList 1", 20, 20, 250, 600);
IR.Log(list_1) // [Object DialogItemPrototype]  // create list and get the link in one action

.Adapter​

Объект, который позволяет работать с отдельными пунктами списка - заполнять их, следить за активностью, изменять свойства и др.

Синтаксис

GList.Adapter = {}

Пример

GList.Adapter = {
total       :  8,  // total number of states after the list creation
GetCount    :  function () {return this.total}, //makes "total" property available for external functions
GetItem     :  function (in_nPos) {},  // function will be called separately for each created item of list. Here you can select template of item, change their properties. in_nPos - index of list item
SetSelected :  function (in_oItem, in_bSelected) {} //  function will be called separately for each created item of list. It returns the link to list item as an object (popup) and the state of activity of this item - is it selected in list or not
}

function good_list (list_item, template)
{
var l_list = list_item;
var l_oTemp = IR.GetItem(template);
l_list.GetState(0).Color = 0xFFFFFFFF;
l_list.SelectMode = 1; // 0 - cannot select, 1 - one selected item, 2 - any number of items can be marked as selected
l_list.Direction = 1;  // 0 - horisontal from left to right, 1 - vertical from up to down
l_list.Adapter = {
//number of list items at start
total: 8,
//function to count the number of list items
GetCount : function ()
{
return this.total;
//use as: IR.Log("Total number of items in list = " + l_oGList.Adapter.GetCount())
},
//function to work with list items
GetItem: function(in_nPos)
{
var l_oItem = l_oTemp.Clone("" + in_nPos);   // use popup as template of List item
l_oItem.GetItem("Item_name").Text = in_nPos; // display the popup position at each list item
// when press to popup in list
IR.AddListener(IR.EVENT_ITEM_RELEASE, l_oItem, function ()
{
l_list.SetSelected(l_oItem);   // mark item as selected
});
// when press to some item of popup in list
IR.AddListener(IR.EVENT_ITEM_RELEASE, l_oItem.GetItem("Add"), function ()
{
l_list.Adapter.total += 1;   //add one more list item
//l_list.Adapter.total -= 1;   //delete the last item of list
l_list.Position = l_list.Adapter.total+1; // go to the last position of list
l_list.Update();   //update list when change the number of items in list from inside or outside
});
return l_oItem;   //get object item
},
//function to work with selected items
SetSelected : function (in_oItem, in_bSelected)
{
if (in_bSelected == true)
{
//IR.Log("selected > "+in_oItem.Name);
in_oItem.GetItem("Selector").Value = 1;
} else  in_oItem.GetItem("Selector").Value = 0;
}
};
return l_list;
}
var l_oGList1 = new good_list(IR.GetPage("Page 1").CreateItem(IR.ITEM_GOOD_LIST, "ConList", 16, 16, 320, 600), "Popup 1");
var l_oGList2 = new good_list(IR.GetPage("Page 1").CreateItem(IR.ITEM_GOOD_LIST, "ConList_2", 352, 16, 320, 600), "Popup 1");
/* * * * *  List Of Methods
*
*  l_oGList1.SetSelected(l_oItem)                               // mark list position as selected
*  l_oGList1.Update()                                           // update list when change the number of items
*  IR.DeleteItem(l_oGList1)                                     // remove List object
*
*  l_oGList1.Adapter.GetCount()                                 // get total number of list positions
*  l_oGList1.Adapter.GetItem(4).GetItem("Item_name").Text       // get list position by index
*  l_oGList1.Adapter.GetItem("4").GetItem("Item_name").Text     // get list position by name
*  l_oGList1.Adapter.total                                      // get or change total number of list positions
*
*  l_oGList1.SelectMode                                         // 0 - cannot select, 1- one selected item, 2 - any number of items can be marked as selected
*  l_oGList1.GetState(0).Color                                  // color of List substate
*  l_oGList1.Direction                                          // 0 - horisontal from left to right, 1 - vertical from up to down
*  l_oGList1.Position                                           // set or get the current list position
*
*****/

.SetSelected()​

пометить пункт списка, как выбранный. Возможность пометить пункт списка зависит от его свойства .SelectMode

Синтаксис

list.SetSelected(item-object);

Пример

var l_oTemp = IR.GetItem("Popup 1");
l_list.Adapter = {
GetItem: function(in_nPos)
{
var l_oItem = l_oTemp.Clone("" + in_nPos);   // use popup as template of List item
IR.AddListener(IR.EVENT_ITEM_RELEASE, l_oItem, function ()
{
l_list.SetSelected(l_oItem);   // mark item as selected on Release
});
}
}

.Update()​

обновить список. Используется после изменения количества пунктов списка

Синтаксис

list.Update();

Пример

var l_oTemp = IR.GetItem("Popup 1");
l_list.Adapter = {
GetItem: function(in_nPos)
{
var l_oItem = l_oTemp.Clone("" + in_nPos);   // use popup as template of List item
IR.AddListener(IR.EVENT_ITEM_RELEASE, l_oItem, function ()
{
l_list.Adapter.total += 1;
l_list.Update();  // update list if number of items has been changed
});
}
}

.GetSelected()​

Получить список отмеченных элементов списка

Синтаксис

list.GetSelected();

Пример

IR.AddListener(IR.EVENT_ITEM_PRESS, IR.GetItem("Page 1").GetItem("Item 1"), function()
{
var SelectedBuffer = l_oGList1.GetSelected();
IR.Log("SelectedBuffer = " + SelectedBuffer );
});

.ClearSelected()​

Убрать выделение со всех элементов

Синтаксис

list.ClearSelected();

Пример

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

Свойства​

Свойства списков - графических элементов типа Good List:

IR.GetItem(page/popup).GetItem(good_list).property

Static List​

Static List - графический элемент, внутри которого можно перелистывать попапы. Используется для создания меню, управляемого жестами.

Static List нельзя создать из скрипта, но можно добавлять и убирать из него попапы, перелистывать список до нужной позиции. Функция определения текущей позиции списка на данный момент отсутствует.

Методы объекта Static List:

// get a link to the Static List as an object
var st_list = IR.GetItem("Page 1").GetItem("Static List Item 1") 

// methods
st_list.AddPopup("Popup 1") // add a popup to the end of Static List (by name)
st_list.RemovePopup("Popup 1") // remove a popup from the Static List (by name)
st_list.SetPosition(0) // set the position of the Static List by the index from 0
st_list.Clear() // clear the Static List (romove all popups)

.AddPopup()​

добавить попап в конце списка Static List. Для этого нужно получить ссылку на объект Static List с помощью метода IR.GetItem().

Синтаксис

st_list.AddPopup(popup_name);

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var st_list = IR.GetItem("Page 1").GetItem("Static List 1");
st_list.AddPopup("Popup 1");
});

.RemovePopup()​

убрать попап из списка Static List, по имени. Обращение по индексу не поддерживается. Требуется получить ссылку на объект Static List с помощью метода IR.GetItem().

Синтаксис

st_list.RemovePopup(popup_name);

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var st_list = IR.GetItem("Page 1").GetItem("Static List 1");
st_list.RemovePopup("Popup 1");
});

.SetPosition()​

переместить список Static List на указанную (индексом) позицию. Индекс позиции отсчитывается с нуля.

Синтаксис

st_list.SetPosition(position);

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var st_list = IR.GetItem("Page 1").GetItem("Static List 1");
st_list.SetPosition(1);
});

.Clear()​

удалить все пункты из списка Static List

Синтаксис

st_list.Clear();

Пример

IR.AddListener(IR.EVENT_START, 0, function()
{
var st_list = IR.GetItem("Page 1").GetItem("Static List 1");
st_list.Clear();
});

Свойства​

Свойства списков - графических элементов типа Static List:

IR.GetItem(page/popup).GetItem(static_list).property

IR.ITEM_PICKER​

Методы, используемые при работе с барабаном - графическим элементом типа Picker.

IR.CreateItem()​

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

Синтаксис

IR.CreateItem(IR.ITEM_PICKER, name, {parameter});

Пример

//create picker with min/max values
var picker = IR.GetItem("Page 1").CreateItem(IR.ITEM_PICKER, "picker", {
X: 55,
Y: 6,
Min: 1, // min value
Max: 31, // max value
Template: IR.GetPopup("Template Picker")
});
//create picker with array
var picker = IR.GetItem("Page 1").CreateItem(IR.ITEM_PICKER, "picker", {
X: 35,
Y: 0,
Items: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], //array
Template: IR.GetPopup("Template Picker")
});

Свойства​

Свойства барабана - графического элемента типа Picker:

IR.GetItem(page/popup).GetItem(picker).property

var picker = IR.GetItem("Page 1").getItem("picker");
//* *  ItemsCount **//
IR.Log(picker.ItemsCount); // 15
//* *  SelectedIndex **//
IR.Log(picker.SelectedIndex); //2

Получение значений с барабана​

Значение можно получить, обратившись к свойству Value элемента Picker.

IR.AddListener(IR.EVENT_ITEM_RELEASE, IR.GetItem(“Page 1”).GetItem("Done_Button"), function() {
    var Day = parseInt(DayPicker.Value); // Day (number)
    var Month = MonthPicker.Value; // Month (string)
    var Year = parseInt(YearPicker.Value); // Year (number)
    IR.Log("Date: " + Day + ", Month: " + Month + ", Year: " + Year); // Logging
  });

IR.EVENT_PICKER_SCROLL​

Данный метод используется для определения прокрутки барабана. После прокрути нужного барабана, можно выполнить действия по отрисовке другого барабана, меняя количество дней в зависимости от выбранного месяца.

Синтаксис

IR.AddListener(IR.EVENT_PICKER_SCROLL, picker, function (in_position / Position), [pointer]);

Пример

IR.AddListener(IR.EVENT_PICKER_SCROLL, MidPicker, function(in_position){                
 
        if (in_position == 3 || in_position == 5 || in_position == 8 || in_position == 10) {          //левый барабан настроить на диапазон 1...30          
 
               var item_test = IR.GetPopup("Remote").GetItem("leftPicker"); 
               IR.DeleteItem(item_test);
 
               in_oRemotePopup.CreateItem(IR.ITEM_PICKER, "leftPicker", {
                  X: _Left.X - 55,
                  Y: _Left.Y + 6,
                  Min: 1, // Интервал
                  Max: 30, //  Интервал
                  VisibleCount: 3, //3,5,7,...
                  Template: IR.GetPopup("Template Picker")
               });  
 
        }
 else if(in_position == 0 || in_position == 2 ||  in_position == 4 || in_position == 6 || in_position == 7 || in_position == 9 || in_position == 11) {    //левый барабан настроить на диапазон 1...31                                                                      
 
               var item_test = IR.GetPopup("Remote").GetItem("leftPicker"); 
               IR.DeleteItem(item_test);
 
               in_oRemotePopup.CreateItem(IR.ITEM_PICKER, "leftPicker", {
                  X: _Left.X - 55,
                  Y: _Left.Y + 6,
                  Min: 1, // Интервал
                  Max: 31, //  Интервал
                  VisibleCount: 3, //3,5,7,...
                  Template: IR.GetPopup("Template Picker")
               });   
 }
else if(in_position == 1){                                   //левый барабан настроить на диапазон 1...28  
 
               var item_test = IR.GetPopup("Remote").GetItem("leftPicker"); 
               IR.DeleteItem(item_test);
 
               in_oRemotePopup.CreateItem(IR.ITEM_PICKER, "leftPicker", {
                  X: _Left.X - 55,
                  Y: _Left.Y + 6,
                  Min: 1, // Интервал
                  Max: 28, // Интервал
                  VisibleCount: 3, //3,5,7,...
                  Template: IR.GetPopup("Template Picker")
               });       
          }                                   
   });  
 }