ui/ru.sydis.ui.core.controls.tree/FilteringTreeItem

FilteringTreeItem

class FilteringTreeItem<T : Any>(value: T) : TreeItem<T>

Универсальный TreeItem с фильтрацией и сортировкой без сторонних библиотек.

Идеи:

Полный список детей хранится в internalChildren (источник истины).
Видимые дети (children) — отфильтрованное/отсортированное зеркало internalChildren.
Предикат predicate может наследоваться от родителя (inheritPredicate); суммарный — effectivePredicate.
Если includeParentsOfMatches = true, родитель остаётся видимым при совпадениях среди потомков.
При отсутствии предиката поведение задаёт includeWhenNoPredicate.
Сортировка применяется только к видимым детям через comparator.
Все изменения UI‑модели происходят на FX‑потоке; множественные запросы батчатся.

Рекомендации:

По возможности используйте FilteringTreeItem для всех узлов дерева, иначе «обычные» дети фильтруются только на своём уровне (их поддеревом эта реализация не управляет).
Не модифицируйте children напрямую — меняйте internalChildren или используйте addAll/setAll.

Constructors

FilteringTreeItem

constructor(value: T)

Properties

autoExpandOnMatch

var autoExpandOnMatch: Boolean

autoExpandOnMatchProperty

val autoExpandOnMatchProperty: SimpleBooleanProperty

Автоматически разворачивать узел, если среди потомков есть совпадения.

children

val children: ObservableList<TreeItem<T>>

comparator

var comparator: Comparator<TreeItem<T>>?

comparatorProperty

val comparatorProperty: ObjectProperty<Comparator<TreeItem<T>>?>

Компаратор видимых детей. Применяется только к «витрине», internalChildren не трогается.

includeParentsOfMatches

var includeParentsOfMatches: Boolean

includeParentsOfMatchesProperty

val includeParentsOfMatchesProperty: SimpleBooleanProperty

Держать родителей видимыми, если у них есть совпадающие потомки.

includeWhenNoPredicate

var includeWhenNoPredicate: Boolean

includeWhenNoPredicateProperty

val includeWhenNoPredicateProperty: SimpleBooleanProperty

Что показывать без предиката: всё (true) или ничего (false).

inheritPredicate

var inheritPredicate: Boolean

inheritPredicateProperty

val inheritPredicateProperty: SimpleBooleanProperty

Наследовать ли предикат от родителя. По умолчанию — да.

internalChildren

val internalChildren: ObservableList<TreeItem<T>>

Полный список детей (не зависит от фильтра).

matchesDescendant

val matchesDescendant: Boolean

matchesDescendantProperty

val matchesDescendantProperty: ReadOnlyBooleanProperty

matchesSelf

val matchesSelf: Boolean

matchesSelfProperty

val matchesSelfProperty: ReadOnlyBooleanProperty

predicate

var predicate: Predicate<T>?

predicateProperty

val predicateProperty: ObjectProperty<Predicate<T>?>

Локальный предикат (null = «локального условия нет»).

Functions

addAll

fun addAll(vararg items: TreeItem<T>)

Добавить одного/нескольких детей в «источник истины».

addEventFilter

open override fun <E : Event> addEventFilter(p0: EventType<E>, p1: EventHandler<in E>)

addEventHandler

open override fun <E : Event> addEventHandler(p0: EventType<E>, p1: EventHandler<in E>)

buildEventDispatchChain

open override fun buildEventDispatchChain(p0: EventDispatchChain): EventDispatchChain

buildPathName

fun TreeItem<ItemTreeDP>.buildPathName(includeRoot: Boolean = false): String

expandedProperty

fun expandedProperty(): BooleanProperty

findById

fun FilteringTreeItem<ItemTreeDPT>.findById(id: Long): FilteringTreeItem<ItemTreeDPT>?

Ищет первый узел в дереве, у которого value.id == id. Возвращает TreeItem или null, если не найден. Сложность: O(N), где N — число узлов.

findElementById

fun TreeItem<ItemTreeDP>.findElementById(id: Long): TreeItem<ItemTreeDP>?

getGraphic

fun getGraphic(): Node

getParent

fun getParent(): TreeItem<T>

getValue

fun getValue(): T

graphicProperty

fun graphicProperty(): ObjectProperty<Node>

isExpanded

fun isExpanded(): Boolean

isLeaf

open fun isLeaf(): Boolean

leafProperty

fun leafProperty(): ReadOnlyBooleanProperty

nextSibling

open fun nextSibling(): TreeItem<T>

open fun nextSibling(p0: TreeItem<T>): TreeItem<T>

parentProperty

fun parentProperty(): ReadOnlyObjectProperty<TreeItem<T>>

previousSibling

open fun previousSibling(): TreeItem<T>

open fun previousSibling(p0: TreeItem<T>): TreeItem<T>

refreshFast

fun refreshFast(treeView: TreeView<T>? = null, children: Collection<out TreeItem<T>>, preserveSelection: Boolean = true)

fun refreshFast(treeView: TreeView<T>? = null, children: Collection<out TreeItem<T>>, structureComparator: Comparator<TreeItem<T>>, recursive: Boolean = false, preserveSelection: Boolean = true)

refreshFastSortedBy

fun <R : Comparable<R>> refreshFastSortedBy(treeView: TreeView<T>? = null, children: Collection<out TreeItem<T>>, selector: (T) -> R?, ascending: Boolean = true, nullsLast: Boolean = true, recursive: Boolean = false, preserveSelection: Boolean = true)

removeEventFilter