Класс AbstractLayoutCache

java.lang.Object

javax.swing.tree.AbstractLayoutCache

Все реализованные интерфейсы:: RowMapper

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

public abstract class AbstractLayoutCache extends Object implements RowMapper

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими ту же версию Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет java.beans. Обратитесь к 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)`	Устанавливает `TreeSelectionModel`, используемый для управления выделением, на новую LSM.
`abstract void`	`treeNodesChanged(TreeModelEvent e)`	Вызывается после того, как узел (или набор элементов) изменился каким-либо образом.
`abstract void`	`treeNodesInserted(TreeModelEvent e)`	Вызывается после того, как узлы были вставлены в дерево.
`abstract void`	`treeNodesRemoved(TreeModelEvent e)`	Вызывается после удаления узлов из дерева.
`abstract void`	`treeStructureChanged(TreeModelEvent e)`	Вызывается после того, как структура дерева сильно изменилась, начиная с заданного узла.

Методы, объявленные в классе java.lang.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

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

rowHeight

protected int rowHeight

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

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

AbstractLayoutCache

protected AbstractLayoutCache()

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

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

setNodeDimensions

public void setNodeDimensions(AbstractLayoutCache.NodeDimensions nd)

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

Parameters:: nd - объект NodeDimensions

getNodeDimensions

public AbstractLayoutCache.NodeDimensions getNodeDimensions()

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

Returns:: объект NodeDimensions

setModel

public void setModel(TreeModel newModel)

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

Parameters:: newModel - TreeModel, предоставляющий данные

getModel

public TreeModel getModel()

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

Returns:: TreeModel, предоставляющий данные

setRootVisible

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

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

Parameters:

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

See Also:

isRootVisible

public boolean isRootVisible()

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

Returns:

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

See Also:

setRowHeight

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

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

Parameters:: rowHeight - высота каждой ячейки в пикселях

getRowHeight

public int getRowHeight()

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

Returns:: высота каждой строки

setSelectionModel

public void setSelectionModel(TreeSelectionModel newLSM)

Устанавливает TreeSelectionModel, используемый для управления выделением, на новый LSM.

Parameters:: newLSM - новый TreeSelectionModel

getSelectionModel

public TreeSelectionModel getSelectionModel()

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

Returns:: treeSelectionModel

getPreferredHeight

public int getPreferredHeight()

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

Returns:: предпочтительная высота

getPreferredWidth

public int getPreferredWidth(Rectangle bounds)

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

Parameters:: bounds - запрашиваемая область
Returns:: предпочтительная ширина для переданной области

isExpanded

public abstract boolean isExpanded(TreePath path)

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

Parameters:: path - проверяемый TreePath
Returns:: развернут ли TreePath

getBounds

public abstract Rectangle getBounds(TreePath path, Rectangle placeIn)

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

Parameters:: path - TreePath, определяющий узел; placeIn - объект Rectangle, предоставляющий доступное пространство
Returns:: объект Rectangle, определяющий используемое пространство

getPathForRow

public abstract TreePath getPathForRow(int row)

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

Parameters:: row - запрашиваемая строка
Returns:: TreePath для данной строки

getRowForPath

public abstract int getRowForPath(TreePath path)

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

Parameters:: path - запрашиваемый TreePath
Returns:: строка, в которой последний элемент пути отображается, или -1, если какие-либо элементы в пути в настоящее время не отображаются

getPathClosestTo

public abstract TreePath getPathClosestTo(int x, int y)

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

Parameters:: x - горизонтальная компонента желаемого местоположения; y - вертикальная компонента желаемого местоположения
Returns:: TreePath, наиболее близкий к указанной точке

getVisiblePathsFrom

public abstract Enumeration<TreePath> getVisiblePathsFrom(TreePath path)

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

Parameters:: path - начальная точка для перечисления
Returns:: Enumerator, начинающийся с желаемого местоположения

getVisibleChildCount

public abstract int getVisibleChildCount(TreePath path)

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

Parameters:: path - запрашиваемый путь
Returns:: количество видимых дочерних элементов для указанного пути

setExpandedState

public abstract void setExpandedState(TreePath path, boolean isExpanded)

Помечает состояние пути path как развернутое состояние isExpanded.

Parameters:: path - путь, который разворачивается или сворачивается; isExpanded - true, если путь должен быть развернут, иначе false

getExpandedState

public abstract boolean getExpandedState(TreePath path)

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

Parameters:: path - запрашиваемый путь
Returns:: 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 - событие изменения узлов

treeNodesInserted

public abstract void treeNodesInserted(TreeModelEvent e)

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

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

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

Параметры:: e - событие вставки узлов

treeNodesRemoved

public abstract void treeNodesRemoved(TreeModelEvent e)

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

e.path() возвращает бывшего родителя удалённых узлов.

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

Параметры:: e - событие удаления узлов

treeStructureChanged

public abstract void treeStructureChanged(TreeModelEvent e)

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

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

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

Параметры:: e - событие изменения структуры дерева

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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/tree/AbstractLayoutCache.html