Класс 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)`	Задаёт `TreeSelectionModel`, используемую для управления выбором, в новое значение LSM.
`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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

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)

Задаёт TreeSelectionModel, используемую для управления выбором, в новую LSM.

Параметры:: 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.