Иерархический список — это виджет древовидной структуры элементов controls, куда в любое время могут быть добавлены новые элементы. В этом списке можно выбрать один или несколько элементов (в зависимости от параметров«selectionMode») и выполнить сортировку (см. «setSorting» и «showSortIndicator») элементов списка по возрастанию или убыванию в любом столбце.
| Доступные функции | Описание |
| «addColumn» | Добавляет столбец в иерархический список. |
| «adjustColumn» | Подстраивает ширину столбца под самую длинную запись. |
| «allColumnsShowFocus» | Фокусировка для всех колонок иерархического списка. |
| «animated» | Эффект анимации при развертывании и сворачивании ветвей списка. |
| «autoCheckParent» | Определяет поведение родительского узла при изменении состояния отметки флажком его дочерних узлов. |
| «appendItem, «appendItemNC» | Функции «appendItem» и «appendItemNC» добавляют элемент в иерархический список. Разница состоит в том, что «appendItemNC» не проверяет дублирующиеся элементы, если таковые имеются. Используйте «appendItemNC» для новых иерархических списков, если не нужно выполнять проверку дубликатов. |
| «autoExpandDelay» | Устанавливает задержку перед открытием или закрытием элемента в древовидной структуре во время операции перетаскивания объектов. |
| «autoScroll» | Используется для включения автопрокрутки в событиях перемещения при перетаскивании. Функция возвращает значение TRUE (ИСТИНА) при включенном режиме автопрокрутки для событий перемещения при перетаскивании, в остальных случаях выводится значение FALSE. (ЛОЖЬ). |
| «autoScrollMargin» | Устанавливает размер области, где будет включаться автоматическая прокрутка. |
| «childCount» | Функция «childCount» возвращает количество подэлементов. |
| «children» | Функция «children» возвращает подэлементы иерархического списка. |
| «clear» | Удаляет элементы иерархического списка. |
| «clearSelection» | Удаляет маркировку всех элементов иерархического списка. |
| «columns» | Возвращает количество колонок (иерархического списка). |
| «columnWidthMode» | Показывает установленный режим для отдельного столбца. |
| «contentsHeight», «contentsWidth» | Функция «contentsHeight» возвращает высоту иерархического списка или текстовой области текстового редактора. Функция «contentsWidth» возвращает значение ширины текстовой области текстового редактора или ширины иерархического списка. |
| «contentsX, «contentsY» | Функции «contentsX» и «contentsY » возвращают координаты иерархического списка или текста текстового редактора. «contentsX» возвращает координату «X» содержимого (текста) в левой части экрана. «contentsY» возвращает координату «Y» содержимого (текста) в верхней части экрана. |
| «currentItem» | Возвращает идентификатор элемента, на котором установлен фокус клавиатуры. |
| «defaultRenameAction» | Функция «defaultRenameAction» указывает выполняемое действие, когда редактор теряет фокус при переименовании (устаревший атрибут, начиная с версии 3.12) |
| «dragEnabled»,»dropEnabled» | С помощью данных функций можно сделать запрос состояния режима «перетаскивание» для элементов иерархического списка. |
| «dropIndicatorPosition» | Возвращает позицию перемещенного объекта. |
| «editTriggers» | Определяет действие, которое включит режим редактирования элемента. |
| «ensureItemVisible» | Функция «ensureItemVisible» принудительно переводит элемент в режим отображения, при необходимости прокручивая список на экране вниз/вверх и открывая (раскрывая) все родительские элементы, если это необходимо для отображения элемента. |
| «expandsOnDoubleClick» | Устанавливает возможность интерактивного разворачивания и сворачивания элементов пользователем. |
| «focus» | Функция «focus» возвращает значение TRUE, если на объекте установлен фокус экрана. |
| «focusEnabled» | Показывает состояние режима фокуса клавиатуры для виджета. |
| «frameShadow» | Функция «frameShadow» задает (3D) эффект рамки для объекта (текстовый редактор, индикатор выполнения, иерархический список, колесо прокрутки, число в стиле ЖК-индикатора или инструмент изменения масштаба). |
| «frameShape» | Функция «frameShape» задает стиль рамки текстового редактора, колеса прокрутки, иерархического списка, инструмента изменения масштаба, числа в стиле ЖК-индикатора или индикатора выполнения. |
| «frameWidth» | Функция «frameWidth» возвращает ширину рамки объекта (текстовый редактор, иерархический список, инструмент изменения масштаба, число в стиле ЖК-индикатора или колесо прокрутки). |
| «getBackColor» | Функция «getBackColor» возвращает цвет фона элемента. |
| «getCheckedItems» | Возвращает список всех отмеченных элементов в иерархическом списке. |
| «getCheckState» | Запрашивает состояние отметки флажком элемента иерархического списка. |
| «getFont» | Функция «getFont» возвращает установленный шрифт элемента. |
| «getForeColor» | Функция «getForeColor» возвращает основной цвет (шрифта) элемента. |
| «getItemsCheckState» | Возвращает карту идентификаторов элементов в виде ключей и состояний отметки флажками в виде значений. |
| «getText» | Возвращает текст элемента. |
| «getToolTip» | Возвращает заданный текст всплывающей подсказки в иерархическом списке. |
| «getUncheckedItems» | Возвращает список всех элементов, которые не отмечены в иерархическом списке. |
| «headerHidden» | Включает/выключает отображение заголовка. |
| «height» | Функция «height» возвращает высоту объекта (текстовый редактор, индикатор выполнения, иерархический список, инструмент изменения масштаба, число в стиле ЖК-индикатора или колесо прокрутки). |
| «hideColumn» | Скрывает столбец в иерархическом списке. |
| «hScrollBarMode» | Функция «hScrollBarMode» устанавливает режим горизонтальной полосы прокрутки для текстового редактора, иерархического списка или таблицы. |
| «insertItem, insertItemNC» | Функции «insertItem» и «insertItemNC» добавляют элемент в иерархический список. Разница состоит в том, что «insertItemNC» не проверяет дублирующиеся элементы, если таковые имеются. Используйте «insertItemNC» для новых иерархических списков, если не нужно выполнять проверку дубликатов. |
| «isActiveWindow» | Функция «isActiveWindow»возвращает значение «TRUE», если виджет является активным окном, в остальных случаях значение FALSE. |
| «isChecked» | Запрашивает состояние отметки флажком для элемента. |
| «isColumnHidden» | Запрашивает состояние определенного столбца (выводится/скрыта). |
| «isEnabled» | Функция показывает, активирован или не активирован элемент (см. «setEnabled»). |
| «isExpandable» | Возвращает значение «TRUE», если элемент раскрываемый даже при отсутствии дочерних элементов, в остальных случаях возвращается значение «FALSE». |
| «isOpen» | Возвращает значение»TRUE», если элемент иерархического списка имеет дочерние элементы, которые визуально на скрыты, в остальных случаях возвращается значение «FALSE». |
| «isVisible» | Возвращает значение «TRUE», если элемент отображается. |
| «itemAbove», itemBelow» | Функция «itemAbove» возвращает элемент, находящийся над указанным элементом, а «itemBelow» возвращает элемент, находящийся под указанным элементом. |
| «itemExists» | Проверяет наличие указанного элемента в иерархическом списке. |
| «itemMargin» | Функция «itemMargin» устанавливает границу элемента иерархического списка (устаревший атрибут, начиная с версии 3.12) |
| «itemsExpandable» | Устанавливает возможность интерактивного разворачивания и сворачивания элементов пользователем. |
| «lineWidth» | Функция «lineWidth» задает толщину линии (рамки) объекта (текстовый редактор, индикатор выполнения, иерархический список, инструмент изменения масштаба, число в стиле ЖК-индикатора или колесо прокрутки). |
| «margin» | Функция «margin» указывает расстояние между пикселями внутренней границы рамки и пикселями внешней границы прямоугольника внутри рамки. (устаревший атрибут, начиная с версии 3.12) |
| «maximumHeight»,»maximumWidth» | Функция «maximumHeight» возвращает максимальное значение высоты окна текстового редактора (без рамки), иерархического списка или ползунка, а функция «maximumWidth» — максимальное значение ширины окна текстового редактора, иерархического списка или ползунка. |
| «minimumHeight», «minimumWidth» | Функция «minimumHeight» возвращает минимальное значение высоты окна текстового редактора (без рамки), иерархического списка или ползунка, а функция «minimumWidth» — минимальное значение ширины окна текстового редактора, иерархического списка или ползунка. |
| «midLineWidth» | Функция «midLineWidth» задает толщину контурной линии (содержимого) объекта (колесо прокрутки, иерархический список, инструмент изменения масштаба, число в стиле ЖК-индикатора или индикатор выполнения). |
| «moveItem» | Изменяет месторасположение элемента в иерархическом списке. |
| «multiSelection» | Позволяет одновременно выбрать несколько элементов иерархического списка (с помощью кнопок SHIFT или CTRL). (функция заменена на «selectionMode», начиная с версии 3.11) |
| «ownCursor» | Функция «ownCursor» возвращает значение TRUE, если объект (текстовый редактор, иерархический список, ползунок, инструмент изменения масштаба или колесо прокрутки) использует свой собственный курсор. При значении FALSE, объект использует курсор родительского виджета. |
| «ownFont» | Функция «ownFont» возвращает значение TRUE, если объект (текстовый редактор, ползунок, инструмент изменения масштаба или колесо прокрутки) использует свой собственный шрифт. При значении FALSE, объект использует шрифт родительского виджета. |
| «parent» | Возвращает родительский элемент для указанного элемента или пустую строку, если у него нет родительского элемента. |
| «removeColumn» | Удаляет столбец иерархического списка. |
| «removeItemId» | Удаляет выбранную запись. |
| «removeItems» | Удаляет выбранные элементы. |
| «resizeMode» | Функция указывает режим изменения размера для колонок (все столбцы, ни один или только последний). (устаревший атрибут, начиная с версии 3.12) |
| «rootIsDecorated» | Функция «rootIsDecorated» указывает режим отображения значков открытия или закрытия элементов корневой структуры. |
| «selectedItem» | Функция «selectedItem» возвращает выбранный элемент, если иерархический список находится в режиме выбора одного элемента и был выделен один элемент. |
| «selectedItems» | Функция «selectedItem» возвращает выбранные элементы, если иерархический список находится в режиме выбора нескольких элементов и были выделены несколько элементов. |
| «selectionBehavior» | Устанавливает режим выбора по одиночным элементам, строкам или столбцам. |
| «selectionMode» | Функция «selectionMode» определяет поведение окна иерархического списка при его выборе пользователем. |
| «setAllChecked» | Выделяет флажками все элементы иерархического списка. |
| «setBackColor» | Функция «setBackColor» определяет цвет фона элемента. |
| «setCheckable» | Устанавливает опцию отметки флажком для узла иерархического списка. |
| «setChecked» | Задает состояние отметки флажком одного или нескольких элементов иерархического списка. |
| «setColumnWidth» | Задает ширину столбца иерархического списка. |
| «setColumnWidthMode» | С помощью атрибута «addColumn()» создается новый столбец с режимом ширины «автоматический». Это значит, что размер ширины столбца подстраивается под самую длинную запись. Функция «setColumnWidthMode()» устанавливает режим, при котором ширина столбца задается вручную. |
| «setDragEnabled», «setDropEnabled» | Данные функции разрешают операцию «перетаскивания» для элементов иерархического списка во время работы программы. |
| «setEnabled» | Активирует или деактивирует элемент. |
| «setExpandable» | Устанавливает свойство «раскрываемый» для элемента, у которого может не быть дочерних элементов (значение TRUE), и «раскрываемый» только в том случае, если у элемента есть дочерние элементы (значение FALSE). |
| «setFont» | Функция «setFont» устанавливает тип шрифта для элемента. |
| «setIcon» | Устанавливает пиктограмму виджета. |
| «setOpen» | Раскрывает элемент, если параметр «open» = TRUE и элемент «раскрываемый», или закрывает элемент, если параметр «open» = FALSE. |
| «setRenameEnabled» | Функция «setRenameEnabled» определяет возможность переименования элемента в столбце, прямо на его месте. |
| «setResizeEnabled» | Предотвращает или разрешает изменение ширины столбцов. |
| «setSelectedItem» | Выбирает определенный элемент. |
| «setSelectedItems» | Выбирает определенные элементы. |
| «setSorting» | Функция сортирует элементы в алфавитном порядке по возрастанию. |
| «setText» | Задает текст для элемента. |
| «setToolTip» | Определяет текст всплывающей подсказки для выбранного элемента в столбце иерархического списка. |
| «setVisible» | Включает отображение элемента. |
| «showDropIndicator» | Включает отображение выпадающего указателя во время операции перетаскивания элемента. |
| «showHeader» | Показывает или скрывает заголовок иерархического списка. |
| «showSortIndicator» | При помощи «showSortIndicator» можно сортировать столбцы по щелчку на их заголовках. |
| «showToolTips» | Включает/выключает отображение всплывающих подсказок на экране иерархического списка для колонок с обрезанным текстом (устаревший атрибут, начиная с версии 3.12) |
| «startRename» | При включенной опции переименования указанного элемента на месте (см. «setRenameEnabled»), данная функция создает и инициализирует окно редактирования для переименовывания элемента в указанном столбце. |
| «sortingEnabled» | Активация функции сортировки. |
| «treeStepSize» | Указывает количество пикселей, на которое будет сдвинут дочерний элемент относительно родительского. |
| «underMouse» | Возвращает значение TRUE, если виджет объекта (текстовый редактор, ползунок, колесо прокрутки, иерархический список, инструмент изменения масштаба, число в стиле ЖК-индикатора или индикатор выполнения) находится под курсором. |
| «updatesEnabled» | Включает/выключает обновления виджета объекта. |
| «visibleHeight» | Задает видимое содержание по вертикали. |
| «visibleWidth» | Задает видимое содержание по горизонтали. |
| «vScrollBarMode» | Функция «vScrollBarMode» устанавливает режим вертикальной полосы прокрутки для текстового редактора, иерархического списка или таблицы. |