Alterator/Widgets/CheckTree

Описание

Виджет для организации иерархического табличного представления с флажками выбора.

Пример

[-] [x] Элемент 1
 +----[ ] Подэлемент
[+] [ ] Свёрнутый элемент

У каждого элемента показывается флажок, который можно установить или снять (с помощью мыши или клавишей Space). При изменении состоянии флажка генерируется сигнал changed

API

Конструктор

(checktree)

Конструктор.

Опциональные параметры:

columns 1

Количество столбцов. По умолчанию — 1.

Свойства

(append-row LIST)

Добавить строку в дерево.

Формат LIST: список полей, разделённый символами «;»:

• item_id — идентификатор элемента. ВНИМАНИЕ! Не используйте в идентификаторах пробелы и «;» — это может привести к сбою работы;
• item_parent_id — идентификатор родительского элемента;
• label_1 — надпись в первом столбце;
• label_X... — (опционально) надписи во втором и последующем столбцах;

(rows LIST)

Добавить список строк в дерево. Строки разделены символом «;». Количество элементов в каждой строке должно быть равно количеству столбцов+2.

(rows-clear)

Удалить все строки в дереве.

(expand-rows LIST)

Развернуть элементы по списку идентификаторов, разделённых символами «;».

(collapse-rows LIST)

Свернуть элементы по списку идентификаторов, разделённых символами «;». По умолчанию все элементы свёрнуты.

(current-rows LIST) → (id_1;id_2...)

Установить флажки для элементов по списку идентификаторов, разделённых символами «;».

Вернуть список идентификаторов отмеченных элементов, разделённые символами «;».

(current ID) → id

Выделить элемент по его идентификатору

Вернуть идентификатор текущего элемента

(icon-rows "ICON;COLUMN;LIST")

Установить значок ICON в столбце COLUMN (нумерация начинается с 1) для элементов по списку идентификаторов, разделённых символами «;».

Сигналы

(changed)

Возникает при изменении состоянии флажка любого элемента.

(selected)

Возникает при выделении (мышью или с клавиатуры) элемента виджета.

Примечание: при щелчке на флажке генерируются оба сигнала: (changed) и (selected)

Пример

;; Create widget and connect two slots to its signals
(document:id packages (checktree columns 2
               (when changed (test-label))
               (when selected (select-label))
;; Fill values
(packages append-row "g1;;Group 1")             ; first top-level item
(packages append-row "gp1;g1;Subgroup")         ; child of first top-level item 
(packages append-row "g2;;Another group;22045") ; second top-level item
;; Set properties
(packages expand-rows "g1")           ; expand top-level item named 'g1'
(packages current-rows "g1;gp1")      ; set checked two items
(packages icon-rows "theme:help;;g1") ; set icon in first column
(packages current "gp1")              ; set current item