Эта страница является
переводом страницы
AMX IRLB Commands. Перевод выполнен на 100%.
Динамические списки в AMX (команды IRLB)
Для отображения списка, например, музыки или фильмов, который меняется в процессе работы проекта
Динамический список iRidium List - элемент проекта, на базе которого в проекте АМХ из одного попапа (шаблона) формируется прокручивающийся список, пункты которого добавляются и удаляются во время работы проекта.
Количество пунктов списка задается командой контроллера, а ограничивается настройками графического элемента - основы списка. Содержимое пункта списка можно изменять с помощью специальных команд.
Подготовка основы списка в AMX TPDesign4
В качестве основы списка всегда используется Multistate-Bargraph:
В поле Description элемента Multistate-Bargraph укажите попап - шаблон пункта списка:
IridiumList=Template_1;
Template_1 - имя попапа, шаблона пунктов списка
Во вкладке Programming элемента Multistate-Bargraph настройте обработку нажатий на пункты списка:
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)
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, название цвета)
