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

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

Описание

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

Пример

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

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

API

Конструктор

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

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

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

Свойства

(append-row DATA)

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

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

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

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

Сигналы

(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")

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