Класс AbstractLayoutCache

java.lang.Object

javax.swing.tree.AbstractLayoutCache

Все реализуемые интерфейсы:: RowMapper

Прямые известные подклассы:: FixedHeightLayoutCache, VariableHeightLayoutCache

public abstract class AbstractLayoutCache extends Object implements RowMapper

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`AbstractLayoutCache.NodeDimensions`	Используется `AbstractLayoutCache` для определения размера и координаты x начала конкретного узла.

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected AbstractLayoutCache.NodeDimensions`	`nodeDimensions`	Объект, отвечающий за получение размера узла.
`protected boolean`	`rootVisible`	True, если отображается корневой узел, false, если верхними видимыми узлами являются его дочерние узлы.
`protected int`	`rowHeight`	Высота, используемая для каждой строки.
`protected TreeModel`	`treeModel`	Модель, предоставляющая информацию.
`protected TreeSelectionModel`	`treeSelectionModel`	Модель выделения.

Краткое описание конструкторов

AbstractLayoutCache()

Модификатор	Конструктор	Описание
`protected`	Конструктор, вызываемый подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract Rectangle`	`getBounds(TreePath path, Rectangle placeIn)`	Возвращает прямоугольник с границами, необходимыми для отрисовки пути.
`abstract boolean`	`getExpandedState(TreePath path)`	Возвращает true, если путь раскрыт и видим.
`TreeModel`	`getModel()`	Возвращает `TreeModel`, предоставляющую данные.
`AbstractLayoutCache.NodeDimensions`	`getNodeDimensions()`	Возвращает объект, который отображает узлы дерева и отвечает за вычисление размеров отдельных узлов.
`protected Rectangle`	`getNodeDimensions(Object value, int row, int depth, boolean expanded, Rectangle placeIn)`	Возвращает по ссылке в `placeIn` размер, необходимый для представления `value`.
`abstract TreePath`	`getPathClosestTo(int x, int y)`	Возвращает путь к узлу, ближайшему к точке x,y.
`abstract TreePath`	`getPathForRow(int row)`	Возвращает путь для заданной строки.
`int`	`getPreferredHeight()`	Возвращает предпочтительную высоту.
`int`	`getPreferredWidth(Rectangle bounds)`	Возвращает предпочтительную ширину заданной области.
`abstract int`	`getRowCount()`	Количество отображаемых строк.
`abstract int`	`getRowForPath(TreePath path)`	Возвращает строку, в которой виден последний элемент, указанный в пути.
`int`	`getRowHeight()`	Возвращает высоту каждой строки.
`int[]`	`getRowsForPaths(TreePath[] paths)`	Возвращает строки, в которых отображаются экземпляры `TreePath` из `path`.
`TreeSelectionModel`	`getSelectionModel()`	Возвращает модель, используемую для управления выделением.
`abstract int`	`getVisibleChildCount(TreePath path)`	Возвращает количество видимых дочерних узлов строки.
`abstract Enumeration<TreePath>`	`getVisiblePathsFrom(TreePath path)`	Возвращает `Enumerator`, перебирающий видимые пути, начиная с заданного местоположения.
`abstract void`	`invalidatePathBounds(TreePath path)`	Уведомляет `LayoutCache` о том, что границы для `path` недействительны и их необходимо обновить.
`abstract void`	`invalidateSizes()`	Сообщает `TreeState` о необходимости пересчитать все используемые ею размеры.
`abstract boolean`	`isExpanded(TreePath path)`	Возвращает true, если значение, определяемое строкой, в данный момент раскрыто.
`protected boolean`	`isFixedRowHeight()`	Возвращает true, если высота каждой строки имеет фиксированный размер.
`boolean`	`isRootVisible()`	Возвращает true, если отображается корневой узел дерева.
`abstract void`	`setExpandedState(TreePath path, boolean isExpanded)`	Устанавливает для пути `path` состояние раскрытия `isExpanded`.
`void`	`setModel(TreeModel newModel)`	Задает `TreeModel`, которая будет предоставлять данные.
`void`	`setNodeDimensions(AbstractLayoutCache.NodeDimensions nd)`	Задает средство визуализации, отвечающее за отрисовку узлов дерева и, следовательно, за вычисление размеров отдельных узлов.
`void`	`setRootVisible(boolean rootVisible)`	Определяет, виден ли корневой узел из `TreeModel`.
`void`	`setRowHeight(int rowHeight)`	Задает высоту каждой ячейки.
`void`	`setSelectionModel(TreeSelectionModel newLSM)`	Устанавливает новую LSM в качестве `TreeSelectionModel` для управления выделением.
`abstract void`	`treeNodesChanged(TreeModelEvent e)`	Вызывается после некоторого изменения узла (или набора соседних узлов).
`abstract void`	`treeNodesInserted(TreeModelEvent e)`	Вызывается после вставки узлов в дерево.
`abstract void`	`treeNodesRemoved(TreeModelEvent e)`	Вызывается после удаления узлов из дерева.
`abstract void`	`treeStructureChanged(TreeModelEvent e)`	Вызывается после существенного изменения структуры дерева, начиная с заданного узла.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

nodeDimensions

protected AbstractLayoutCache.NodeDimensions nodeDimensions

Объект, отвечающий за получение размера узла.

treeModel

protected TreeModel treeModel

Модель, предоставляющая информацию.

treeSelectionModel

protected TreeSelectionModel treeSelectionModel

Модель выделения.

rootVisible

protected boolean rootVisible

True, если отображается корневой узел, false, если верхними видимыми узлами являются его дочерние узлы.

rowHeight

protected int rowHeight

Высота, используемая для каждой строки. Если это значение меньше или равно 0, для определения высоты каждой строки будет использоваться средство визуализации.

Подробное описание конструкторов

AbstractLayoutCache

protected AbstractLayoutCache()

Конструктор, вызываемый подклассами.

Подробное описание методов

setNodeDimensions

public void setNodeDimensions(AbstractLayoutCache.NodeDimensions nd)

Задает средство визуализации, отвечающее за отрисовку узлов дерева и, следовательно, за вычисление размеров отдельных узлов.

Параметры:: nd — объект NodeDimensions

getNodeDimensions

public AbstractLayoutCache.NodeDimensions getNodeDimensions()

Возвращает объект, который отображает узлы дерева и отвечает за вычисление размеров отдельных узлов.

Возвращает:: объект NodeDimensions

setModel

public void setModel(TreeModel newModel)

Задает TreeModel, которая будет предоставлять данные.

Параметры:: newModel — TreeModel, которая будет предоставлять данные

getModel

public TreeModel getModel()

Возвращает TreeModel, предоставляющую данные.

Возвращает:: TreeModel, предоставляющую данные

setRootVisible

@BeanProperty(description="Whether or not the root node from the TreeModel is visible.") public void setRootVisible(boolean rootVisible)

Определяет, виден ли корневой узел из TreeModel.

Параметры:

rootVisible — true, если корневой узел дерева должен отображаться

См. также:

isRootVisible

public boolean isRootVisible()

Возвращает true, если отображается корневой узел дерева.

Возвращает:

true, если отображается корневой узел дерева

См. также:

setRowHeight

@BeanProperty(description="The height of each cell.") public void setRowHeight(int rowHeight)

Задает высоту каждой ячейки. Если указанное значение меньше или равно нулю, у текущего средства визуализации ячеек запрашивается высота каждой строки.

Параметры:: rowHeight — высота каждой ячейки в пикселях

getRowHeight

public int getRowHeight()

Возвращает высоту каждой строки. Если возвращенное значение меньше или равно 0, высота каждой строки определяется средством визуализации.

Возвращает:: высоту каждой строки

setSelectionModel

public void setSelectionModel(TreeSelectionModel newLSM)

Задает новую LSM в качестве TreeSelectionModel для управления выделением.

Параметры:: newLSM — новая TreeSelectionModel

getSelectionModel

public TreeSelectionModel getSelectionModel()

Возвращает модель, используемую для управления выделением.

Возвращает:: treeSelectionModel

getPreferredHeight

public int getPreferredHeight()

Возвращает предпочтительную высоту.

Возвращает:: предпочтительную высоту

getPreferredWidth

public int getPreferredWidth(Rectangle bounds)

Возвращает предпочтительную ширину заданной области. Область определяется путем, ближайшим к (bounds.x, bounds.y), и заканчивается на bounds.height + bounds.y. Если bounds равно null, будет возвращена предпочтительная ширина всех узлов (это может быть ОЧЕНЬ затратным вычислением).

Параметры:: bounds — запрашиваемая область
Возвращает:: предпочтительную ширину заданной области

isExpanded

public abstract boolean isExpanded(TreePath path)

Возвращает true, если значение, определяемое строкой, в данный момент раскрыто.

Параметры:: path — проверяемый TreePath
Возвращает:: раскрыт ли TreePath

getBounds

public abstract Rectangle getBounds(TreePath path, Rectangle placeIn)

Возвращает прямоугольник с границами, необходимыми для отрисовки пути.

Параметры:: path — TreePath, указывающий узел; placeIn — объект Rectangle, задающий доступное пространство
Возвращает:: объект Rectangle, задающий используемое пространство

getPathForRow

public abstract TreePath getPathForRow(int row)

Возвращает путь для заданной строки. Если строка не видна, возвращается null.

Параметры:: row — запрашиваемая строка
Возвращает:: TreePath для заданной строки

getRowForPath

public abstract int getRowForPath(TreePath path)

Возвращает строку, в которой виден последний элемент, указанный в пути. Возвращает -1, если какой-либо элемент пути в данный момент не виден.

Параметры:: path — запрашиваемый TreePath
Возвращает:: строку, в которой виден последний элемент пути, или -1, если какой-либо элемент пути в данный момент не виден

getPathClosestTo

public abstract TreePath getPathClosestTo(int x, int y)

Возвращает путь к узлу, ближайшему к точке x,y. Если в данный момент ничего не видно, будет возвращено null; в противном случае всегда будет возвращен допустимый путь. Чтобы проверить, находится ли возвращенный объект точно в точке x, y, получите границы возвращенного пути и сравните с ними координаты x, y.

Параметры:: x — горизонтальная координата искомого местоположения; y — вертикальная координата искомого местоположения
Возвращает:: TreePath, ближайший к указанной точке

getVisiblePathsFrom

public abstract Enumeration<TreePath> getVisiblePathsFrom(TreePath path)

Возвращает Enumerator, последовательно перебирающий видимые пути, начиная с заданного местоположения. Порядок элементов перечисления соответствует порядку отображения путей. Первым элементом возвращенного перечисления будет path, если он виден; в противном случае будет возвращен null.

Параметры:: path — начальное местоположение для перечисления
Возвращает:: Enumerator, начинающийся с заданного местоположения

getVisibleChildCount

public abstract int getVisibleChildCount(TreePath path)

Возвращает количество видимых дочерних узлов строки.

Параметры:: path — запрашиваемый путь
Возвращает:: количество видимых дочерних узлов указанного пути

setExpandedState

public abstract void setExpandedState(TreePath path, boolean isExpanded)

Устанавливает для пути path состояние раскрытия isExpanded.

Параметры:: path — раскрываемый или сворачиваемый путь; isExpanded — true, если путь следует раскрыть, иначе false

getExpandedState

public abstract boolean getExpandedState(TreePath path)

Возвращает true, если путь раскрыт и видим.

Параметры:: path — запрашиваемый путь
Возвращает:: true, если путь раскрыт и видим, иначе false

getRowCount

public abstract int getRowCount()

Количество отображаемых строк.

Возвращает:: количество отображаемых строк

invalidateSizes

public abstract void invalidateSizes()

Сообщает TreeState о необходимости пересчитать все используемые ею размеры.

invalidatePathBounds

public abstract void invalidatePathBounds(TreePath path)

Уведомляет LayoutCache о том, что границы для path недействительны и их необходимо обновить.

Параметры:: path — обновляемый путь

treeNodesChanged

public abstract void treeNodesChanged(TreeModelEvent e)

Вызывается после некоторого изменения узла (или набора соседних узлов). Узлы не меняли своего положения в дереве и их массивы дочерних узлов не изменились, однако изменились другие атрибуты, которые могут повлиять на отображение. Например, изменилось имя файла, но его расположение в файловой системе осталось прежним.

e.path() возвращает путь к родительскому узлу измененного узла или измененных узлов.

e.childIndices() возвращает индексы измененного узла или измененных узлов.

Параметры:: e — TreeModelEvent

treeNodesInserted

public abstract void treeNodesInserted(TreeModelEvent e)

Вызывается после вставки узлов в дерево.

e.path() возвращает родительский узел новых узлов.

e.childIndices() возвращает индексы новых узлов в порядке возрастания.

Параметры:: e — TreeModelEvent

treeNodesRemoved

public abstract void treeNodesRemoved(TreeModelEvent e)

Вызывается после удаления узлов из дерева. Обратите внимание: если из дерева удаляется поддерево, этот метод может быть вызван только один раз для корня удаленного поддерева, а не для каждого отдельного удаленного набора соседних узлов.

e.path() возвращает бывший родительский узел удаленных узлов.

e.childIndices() возвращает индексы узлов до их удаления в порядке возрастания.

Параметры:: e — TreeModelEvent

treeStructureChanged

public abstract void treeStructureChanged(TreeModelEvent e)

Вызывается после существенного изменения структуры дерева, начиная с заданного узла. Если путь, возвращаемый e.getPath(), имеет длину один и его первый элемент не указывает на текущий корневой узел, первый элемент должен стать новым корнем дерева.

e.path() содержит путь к узлу.

e.childIndices() возвращает null.

Параметры:: e — TreeModelEvent

getRowsForPaths

public int[] getRowsForPaths(TreePath[] paths)

Возвращает строки, в которых отображаются экземпляры TreePath из path. Этот метод должен возвращать массив той же длины, что и переданный массив. Если один из TreePaths в path недопустим, соответствующий элемент массива должен иметь значение -1.

Определено в:: getRowsForPaths в интерфейсе RowMapper
Параметры:: paths — массив запрашиваемых TreePath
Возвращает:: массив той же длины, что и переданный, содержащий строки, в которых отображается каждый соответствующий TreePath; если paths равно null, возвращается null

getNodeDimensions

protected Rectangle getNodeDimensions(Object value, int row, int depth, boolean expanded, Rectangle placeIn)

Возвращает по ссылке в placeIn размер, необходимый для представления value. Если inPlace равно null, должен быть возвращен вновь созданный Rectangle; в противном случае значение следует поместить в inPlace и вернуть. Если средство визуализации отсутствует, возвращается null.

Параметры:: value — представляемый value; row — запрашиваемая строка; depth — глубина строки; expanded — true, если строка раскрыта, иначе false; placeIn — Rectangle, содержащий размер, необходимый для представления value
Возвращает:: Rectangle, содержащий размеры узла, или null, если размер узла не определен

isFixedRowHeight

protected boolean isFixedRowHeight()

Возвращает true, если высота каждой строки имеет фиксированный размер.

Возвращает:: имеет ли высота каждой строки фиксированный размер

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/tree/AbstractLayoutCache.html