Иерархический список позволяет отображать элементы в виде древовидной структуры, управлять данными элементами и добавлять новые элементы в любой момент времени. Иерархический список поддерживает единичный или множественный выбор элементов (в зависимости от значения свойства «Режим выбора» (selectionMode)), а также сортировку элементов списка по любому столбцу в возрастающем или убывающем порядке (см. свойства «setSorting» и «showSortIndicator«).
Для добавления столбцов в список используется метод «addColumn«. Для добавления в список элементов используется метод / параметр «appendItem«. Иерархическая структура элементов (подчиненность элементов) определяется только на уровне первого столбца. Оставшиеся столбцы могут содержать только тексты описаний (записи в столбцах элементов), добавляемые с помощью «setText«. См. пример в описании метода «appendItem«.
Метод «moveItemId» используется для перемещения элементов. Поскольку иерархический список поддерживает множественный выбор, список должен обеспечивать выполнение независящих друг от друга операции с выборкой и с фокусом клавиатуры. Для этих целей созданы отдельные методы для управления выборкой «(setSelectedItem)», а также для считывания идентификатора элемента в фокусе клавиатуры «(currentItem)».
При активированном режиме единичного выбора в один и тот же момент времени может быть выбран только один элемент (например, щелчком по элементу). При активированном режиме множественного выбора («Multi») одновременно могут быть выбраны несколько элементов.
Перемещение по списку возможно при помощи мыши или клавиатуры. В том случае, если элемент содержит дочерние элементы, их скрытие осуществляется при помощи значка » — «, отображение — при помощи значка » + «.
В том случае, если используются методы «setSorting» и «showSortIndicator«, а фокус находится в пределах списка, при вводе букв запускается поиск. Например, при вводе символа «b», текущим элементом назначается первый обнаруженный элемент, начинающийся с буквы «b».
Рисунок: Иерархический список
ПРОЦЕСС СОЗДАНИЯ ИЕРАРХИЧЕСКОГО СПИСКА
- Щелкните левой кнопкой мыши по пиктограмме с изображением иерархического списка
. - Визуально выберите в рабочей области панели точку, в которой будет находиться один из углов иерархического списка, и переместите курсор мыши в данную точку. Нажмите и удерживайте нажатой левую кнопку мыши. Визуально выберите в рабочей области панели точку, в которой будет находиться противоположный угол иерархического списка, и, удерживая нажатой левую кнопку мыши, переместите курсор мыши в данную точку. Отпустите кнопку мыши для завершения создания иерархического списка.
- Откройте Редактор свойств.
- При необходимости измените имя объекта (Имя (Name)).
- На вкладке «Расширенные» задайте дополнительные свойства Иерархического списка, например, «Режим выбора» (selectionMode) и «treeStepSize» (величина отступа в иерархическом списке) (см. «Свойства комплексных графических объектов» и «Язык сценариев Control/Функции для работы с графическими объектами/Иерархический список (функции Control)«).
При двойном щелчке по Иерархическому списку, находящемуся в режиме редактирования, происходит открытие сценария для события Clicked в Редакторе сценариев.
ПРИМЕЧАНИЕ
Нажатие клавиши пробела приводит к наступлению события «Clicked» Иерархического списка, при этом в качестве номера столбца возвращается » -2 «.