Материал из for iRidium developers
Перейти к: навигация, поиск
Эта страница является переводом страницы AMX IRLB Commands. Перевод выполнен на 100%.

Other languages:

Динамические списки в AMX (команды IRLB)

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

Динамический список iRidium List - элемент проекта, на базе которого в проекте АМХ из одного попапа (шаблона) формируется прокручивающийся список, пункты которого добавляются и удаляются во время работы проекта.

Количество пунктов списка задается командой контроллера, а ограничивается настройками графического элемента - основы списка. Содержимое пункта списка можно изменять с помощью специальных команд.


Подготовка основы списка в AMX TPDesign4

В качестве основы списка всегда используется Multistate-Bargraph:

AMX DinList AddBase1.png

В поле Description элемента Multistate-Bargraph укажите попап - шаблон пункта списка:

AMX DinList AddTemplate.png

IridiumList=Template_1;

Template_1 - имя попапа, шаблона пунктов списка

Во вкладке Programming элемента Multistate-Bargraph настройте обработку нажатий на пункты списка:

AMX DinList AddBase2.png

Address Code

используется для управления списком с контроллера.
Если отправить значение 10 на <Address Code> списка, то он позиционируется на 10м пункте (если такой есть)

Level Code

используется для слежения за нажатиями на элементы списка. Level Code отправляет контроллеру информацию о том, на какой пункт и под-пункт элемента нажали. Если задать Level Code: 401 и нажать на 10й пункт списка, то контроллер получит значение 10 в Level Code: 401. Информация о нажатом под-пункте списка приходит в следующий по порядку Level Code: 402. Если на 10м пункте списка есть 3 подпункта, и мы нажали на второй подпункт, то в Level Code: 402 придет значение 2 (отсчет с нуля: 0 - подложка элемента, 1 - первый подпункт, ...)

При нажатии на пункт списка, он отправляет контроллеру АМХ свой идентификатор и идентификатор под-элемента, на который было произведено нажатие. Контроллер обрабатывает эти два значения и вызывает соответствующий им сценарий

Идентификатор первого пункта списка (ID первого элемента) указывается при создании списка командой IRLB_ADD.

Значение, выбранное на уровне или джойстике, контроллеру НЕ отправится, т.к. фиксируется исключительно сам факт нажатия на под-элемент.


Команды IRLB: управление списками

Команды IRLB - набор команд, отправлять которые можно только приложениям-клиентам iRidium, они не воспринимаются стандартными AMX TouchPanel.


1. Добавление указанного количества элементов в список

send_command dvTP, "'IRLB_ADD-<address,count,start_id>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • count - число элементов списка, которое необходимо создать
  • start_id - идентификатор первого элемента в списке


Пример: создать список из 25 пунктов (основа - элемент с Code:400, число пунктов - 25, ID первого пункта - 0)

AMX DinList SendAdd.png


2. Удаление указанного элемента по ID

send_command dvTP, "'IRLB_DELETE-<address,id>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке, который нужно удалить


3. Удаление всех элементов

send_command dvTP, "'IRLB_CLEAR-<address>'" 
  • address - адрес элемента, основы списка (Multistate-Bargraph)


4. Установка "сопротивления" списка движению в процентах 0-100% (0 - нет трения, 100 - нет движения)

send_command dvTP, "'IRLB_RESISTENCE-<address,value>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • value - значение "сопротивления" в диапазоне от 0 до 100


5. Установка позиции списка

send_command dvTP, "'IRLB_POSITION-<address,id>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке, к которому нужно перейти


6. Установка цвета списка

send_command dvTP, "'IRLB_SCROLL_COLOR-<address,color>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • color - цвет (HEX, RGB, название цвета)


7. Установка координаты под-элемента списка по горизонтали

send_command dvTP, "'IRLB_ITEM_X-<address,id,subitem,value>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • value - значение координаты X элемента в пикселях


8. Установка координаты под-элемента списка по вертикали

send_command dvTP, "'IRLB_ITEM_Y-<address,id,subitem,value>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • value - значение координаты Y элемента в пикселях


9. Установка ширины под-элемента списка

send_command dvTP, "'IRLB_ITEM_WIDTH-<address,id,subitem,value>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • value - ширина элемента в пикселях


10. Установка высоты под-элемента списка

send_command dvTP, "'IRLB_ITEM_HEIGHT-<address,id,subitem,value>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • value - высота элемента в пикселях


11. Установка цвета под-элемента

send_command dvTP, "'IRLB_ITEM_COLOR-<address,id,subitem,color>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • color - цвет (HEX, RGB, название цвета)


12. Установка прозрачности под-элемента списка

send_command dvTP, "'IRLB_ITEM_OPACITY-<address,id,subitem,value>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • value - значение прозрачности элемента в диапазоне от 0 до 255


13. Установка текста под-элемента списка в формате CP1251

send_command dvTP, "'IRLB_ITEM_TEXT-<address,id,subitem,string>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • string - строка в формате CP1251

14. Установка текста под-элемента в формате Unicode send_command dvTP, "'IRLB_ITEM_UNI-<address,id,subitem,string>'"

  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • string - строка в формате Unicode


15. Установка цвета текста под-элемента

send_command dvTP, "'IRLB_ITEM_TEXT_COLOR-<address,id,subitem,color>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • color - цвет (HEX, RGB, название цвета)


16. Установка выравнивания текста под-элемента

send_command dvTP, "'IRLB_ITEM_TEXT_ALIGN-<address,id,subitem,align>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • align - способ выравнивания

17. Установка изображения под-элемента

send_command dvTP, "'IRLB_ITEM_IMAGE-<address,id,subitem,image name>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • image name - имя изображения, добавленного в галерею проекта


18. Установка выранивания изображения под-элемента

send_command dvTP, "'IRLB_ITEM_IMAGE_ALIGN-<address,id,subitem,align>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • align - способ выравнивания


19. Установка иконки под-элемента

send_command dvTP, "'IRLB_ITEM_ICON_ALIGN-<address,id,subitem,name>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • name - имя изображения, добавленного в галерею проекта


20. Установка выравнивания иконки под-элемента

send_command dvTP, "'IRLB_ITEM_ICON_ALIGN-<address,id,subitem,align>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • align - способ выравнивания


21. Установка бордюра под-элемента по идентификатору

send_command dvTP, "'IRLB_ITEM_BORDER-<address,id,subitem,border>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • border - тип бордюра

22. Установка цвета бордюра под-элемента

send_command dvTP, "'IRLB_ITEM_BORDER_COLOR-<address,id,subitem,color>'"
  • address - адрес элемента, основы списка (Multistate-Bargraph)
  • id - идентификатор элемента в списке
  • subitem - идентификатор под-элемента в списке (начинается с нуля, 0 - подложка и т.д.)
  • color - цвет (HEX, RGB, название цвета)