Alterator/Widgets/CheckTree
Материал из ALT Linux Wiki
(Различия между версиями)
(→Свойства) |
(→Пример) |
||
Строка 64: | Строка 64: | ||
(packages append-row "g2;;Another group;22045") ; second top-level item | (packages append-row "g2;;Another group;22045") ; second top-level item | ||
;; Set properties | ;; Set properties | ||
- | (packages expand-rows "g1") | + | (packages expand-rows "g1") ; expand top-level item named 'g1' |
- | (packages current-rows "g1;gp1") | + | (packages current-rows "g1;gp1") ; set checked two items |
- | (packages icon-rows "theme:help;g1") ; set icon | + | (packages icon-rows "theme:help;;g1") ; set icon in first column |
- | (packages current "gp1") | + | (packages current "gp1") ; set current item |
[[Категория:Виджеты Alterator]] | [[Категория:Виджеты Alterator]] |
Версия 14:12, 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 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)
- Возникает при выделении (мышью или с клавиатуры) элемента виджета.
Пример
;; 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 fist 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