List

List является первым и самым простым из семейства регулярных компонентов, предназначенных для отображения структуры данных из циклически повторяемых записей, содержащих поля txt, ico и com. List одномерен.

Компонент List

Особенность регулярных компонентов состоит в том, что они формируются sFF по регулярной модели, которая в виде JSON-строки передаётся в sFF и назначается регулярному компоненту, как значение свойства *Model.data, и, при помощи внутренних методов компонента, отрисовывается с учётом его визуальных настроек.

Свойства List

вКласс, свойство	Комментарий
List	Включенный класс компонента List
currentComment	Значение поля com текущей позиции
currentIcon	Значение поля ico текущей позиции
currentIndex	Индекс (номер) текущей позиции
currentRowColor	Устанавливает цвет выбранной ячейки
currentText	Значение поля txt текущей позиции
selectionColor	Устанавливает цвет выбираемой ячейки (под курсором)
ListCell	Включенный класс оформления ячейки
cellHeight	Высота ячейки
commFontBold	Жирный шрифт комментария
commFontColor	Цвет шрифта комментария
commFontItalic	Курсивный шрифт комментария
commVisible	Видимость комментария
fontFamily	Имя шрифта
fontSize	Размер шрифта
horzAlign	Горизонтальное выравнивание блоков текста и иконки в ячейке
horzIndent	Отступ блоков текста от иконки
iconVisible	Видимость иконки
textFontBold	Жирный шрифт текста
textFontColor	Цвет шрифта текста
textFontItalic	Курсивный шрифт текста
textVisible	Видимость текста
vertAlign	Вертикальное выравнивание блоков текста и иконки в ячейке
ListModel	Включенный класс модели данных
data	JSON-строка данных
length	Количество ячеек, которые могут быть заполнены данными модели

List состоит из цепочки ячеек. В каждой ячейке находится текст, иконка и комментарий, получаемые из модели. Все иконки и текстовые блоки всегда позиционированы друг относительно друга следующим образом: слева отображается иконка высотой почти в высоту ячейки, затем, через отступ ListCell.horzIndent, блок из текста (сверху) и комментария (снизу). Отображаемый вид ячейки настраивается свойствами включенного класса ListCell. Видимость любого из полей (txt, ico, com) может отключена. При этом, в зависимости от горизонтального выравнивания, их взаимная позиция изменяется.

При выборе текущей ячейки изменяются свойства List.currentIndex, List.currentText, List.currentIcon и List.currentComment. Для свойства List.currentIndex можно выполнить обратную операцию - установить номер текущей позиции компонента, вслед за чем изменится положение текущей ячейки и, соответственно, три остальные свойства List.currentText, List.currentIcon и List.currentComment.

Ниже будет рассмотрен пример работы с регулярными компонентами.