ListView — дочерний элемент управления

1. Синтаксис

Дочерний элемент управления ListView использует атрибут children_layout для определения своего синтаксиса:

ListView дочерний элемент => list_view '(' PARAM_LIST ')'
PARAM_LIST => PARAM | PARAM ',' PARAM_LIST

Дочерний элемент ListView используется только для элемента ScrollView в ListView, если не требуется указать поля, отступы или время анимации при удалении элемента. В противном случае этот параметр обычно не указывается.

Пример:

<list_view x="0"  y="30" w="100%" h="-80" item_height="60">
  <scroll_view name="view" x="0"  y="0" w="100%" h="100%" children_layout="list_view(m=10,s=15)">

2. Параметры

ListView предоставляет следующие параметры для дочерних элементов управления:

Примечание: после установки свойства animating_time эффект анимации будет перемещать элемент из исходного положения в конечное положение с заданной скоростью. Поэтому перед добавлением элемента убедитесь, что его координаты соответствуют ожидаемым. Например, чтобы вставить элемент C между элементами A и B, координаты элемента C должны совпадать с координатами элемента A до добавления элемента C.

В коде можно включить дочерний элемент управления с помощью функции widget_set_children_layout:

/**
 * @method widget_set_children_layout
 * Устанавливает параметры макета дочернего элемента управления.
 * @annotation ["scriptable"]
 * @param {widget_t*} widget Объект элемента управления.
 * @param {const char*} params Параметры макета.
 *
 * @return {ret_t} Возвращает RET_OK в случае успеха, иначе указывает на ошибку.
 */
ret_t widget_set_children_layout(widget_t* widget, const char* params);

Пример:

widget_set_children_layout(w, "list_view(m=10,s=15)");

В XML можно установить свойство children_layout:

<list_view x="0"  y="30" w="100%" h="-80" item_height="60">
  <scroll_view name="view" x="0"  y="0" w="100%" h="100%" children_layout="list_view(m=10,s=15)">