Alterator/Widgets/CheckTree: различия между версиями

Версия от 14:20, 20 апреля 2010

Описание

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

Пример

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

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

API

Конструктор

(checktree): Конструктор.

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

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

Свойства

(append-row LIST)

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

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

item_id — идентификатор элемента;
item_parent_id — идентификатор родительского элемента;
label_1 — надпись в первом столбце;
label_X... — (опционально) надписи во втором и последующем столбцах;

(rows DATA): Добавить список строк в дерево. Строки разделены символом «;».
(rows-clear): Удалить все строки в дереве.
(expand-rows LIST): Развернуть элементы по списку идентификаторов, разделённых символами «;». Если параметр LIST не указан, развораются все элементы.
(collapse-rows LIST): Свернуть элементы по списку идентификаторов, разделённых символами «;». Если параметр LIST не указан, сворачиваются все элементы (поведение по умолчанию).
(state-rows LIST) --> (id_1;id_2...): Установить флажки для элементов по списку идентификаторов, разделённых символами «;».; Вернуть список идентификаторов отмеченных элементов, разделённые символами «;».
(icon-rows ICON LIST): Установить значок в первом столбце для элементов по списку идентификаторов, разделённых символами «;».

Сигналы

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

Пример

(document:id packages (checktree focus #t columns 2
               (when changed (test-label))))
(widget append-row "g1;;Group 1")
(widget append-row "gp1;g1;Subgroup")
(widget append-row "g2;;Another group;22045")

@@ Строка 23: / Строка 23: @@
 === Свойства ===
-;(append-row DATA)
+;(append-row LIST)
 :Добавить строку в дерево.
-:Формат DATA: список, разделённый символами «;»:
+:Формат LIST: список полей, разделённый символами «;»:
 :* item_id — идентификатор элемента;
 :* item_parent_id — идентификатор родительского элемента;
@@ Строка 31: / Строка 31: @@
 :* label_X... — (опционально) надписи во втором и последующем столбцах;
 ;(rows DATA)
-:Добавить список строк в дерево. Строки разделены символом <tt>\n</tt>.
+:Добавить список строк в дерево. Строки разделены символом «;».
 ;(rows-clear)
 :Удалить все строки в дереве.
@@ Строка 41: / Строка 41: @@
 :Установить флажки для элементов по списку идентификаторов, разделённых символами «;».
 :Вернуть список идентификаторов отмеченных элементов, разделённые символами «;».
+;(icon-rows ICON LIST)
+:Установить значок в первом столбце для элементов по списку идентификаторов, разделённых символами «;».
 === Сигналы ===