Класс VariableHeightLayoutCache

java.lang.Object

javax.swing.tree.AbstractLayoutCache

javax.swing.tree.VariableHeightLayoutCache

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

public class VariableHeightLayoutCache extends AbstractLayoutCache

ПРИМЕЧАНИЕ: В будущем выпуске этот класс станет более открытым.

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

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

Вложенные классы и интерфейсы, объявленные в классе AbstractLayoutCache

AbstractLayoutCache.NodeDimensions

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

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

Поля, объявленные в классе AbstractLayoutCache

nodeDimensions, rootVisible, rowHeight, treeModel, treeSelectionModel

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

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

Конструктор	Описание
`VariableHeightLayoutCache()`	Создает `VariableHeightLayoutCache`.

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

Модификатор и тип	Метод	Описание
`Rectangle`	`getBounds(TreePath path, Rectangle placeIn)`	Возвращает `Rectangle`, охватывающий область метки, в которой будет нарисован элемент, указанный `path`.
`boolean`	`getExpandedState(TreePath path)`	Возвращает true, если путь развернут и видим.
`TreePath`	`getPathClosestTo(int x, int y)`	Возвращает путь к узлу, ближайшему к точке x,y.
`TreePath`	`getPathForRow(int row)`	Возвращает путь для `row`.
`int`	`getPreferredHeight()`	Возвращает предпочтительную высоту.
`int`	`getPreferredWidth(Rectangle bounds)`	Возвращает предпочтительные ширину и высоту области в `visibleRegion`.
`int`	`getRowCount()`	Возвращает количество видимых строк.
`int`	`getRowForPath(TreePath path)`	Возвращает строку, в которой виден последний элемент, указанный в пути.
`int`	`getVisibleChildCount(TreePath path)`	Возвращает количество видимых дочерних элементов для `path`.
`Enumeration<TreePath>`	`getVisiblePathsFrom(TreePath path)`	Возвращает `Enumerator`, перебирающий видимые пути, начиная с переданного местоположения.
`void`	`invalidatePathBounds(TreePath path)`	Указывает `LayoutCache`, что границы для `path` недействительны и должны быть обновлены.
`void`	`invalidateSizes()`	Сообщает `TreeState` о необходимости пересчитать все используемые размеры.
`boolean`	`isExpanded(TreePath path)`	Возвращает true, если значение, указанное `path`, в данный момент развернуто.
`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`	`treeNodesChanged(TreeModelEvent e)`	Вызывается после изменения узла (или набора соседних узлов).
`void`	`treeNodesInserted(TreeModelEvent e)`	Вызывается после вставки узлов в дерево.
`void`	`treeNodesRemoved(TreeModelEvent e)`	Вызывается после удаления узлов из дерева.
`void`	`treeStructureChanged(TreeModelEvent e)`	Вызывается после значительного изменения структуры дерева, начиная с указанного узла.

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

getModel, getNodeDimensions, getNodeDimensions, getRowHeight, getRowsForPaths, getSelectionModel, isFixedRowHeight, isRootVisible, setSelectionModel

Модификатор и тип	Метод	Описание
`TreeModel`	`getModel()`	Возвращает `TreeModel`, предоставляющую данные.
`AbstractLayoutCache.NodeDimensions`	`getNodeDimensions()`	Возвращает объект, который отображает узлы дерева и отвечает за вычисление размеров отдельных узлов.
`protected Rectangle`	`getNodeDimensions(Object value, int row, int depth, boolean expanded, Rectangle placeIn)`	Возвращает по ссылке в `placeIn` размер, необходимый для представления `value`.
`int`	`getRowHeight()`	Возвращает высоту каждой строки.
`int[]`	`getRowsForPaths(TreePath[] paths)`	Возвращает строки, в которых отображаются экземпляры `TreePath` в `path`.
`TreeSelectionModel`	`getSelectionModel()`	Возвращает модель, используемую для управления выбором.
`protected boolean`	`isFixedRowHeight()`	Возвращает true, если высота каждой строки имеет фиксированное значение.
`boolean`	`isRootVisible()`	Возвращает true, если корневой узел дерева отображается.
`void`	`setSelectionModel(TreeSelectionModel newLSM)`	Задает новый LSM — `TreeSelectionModel`, используемый для управления выбором.

Методы, объявленные в классе 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, либо истечения заданного интервала реального времени.

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

VariableHeightLayoutCache

public VariableHeightLayoutCache()

Создает VariableHeightLayoutCache.

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

setModel

@BeanProperty(description="The TreeModel that will provide the data.") public void setModel(TreeModel newModel)

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

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

setRootVisible

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

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

Переопределяет:

setRootVisible в классе AbstractLayoutCache

Параметры:

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

См. также:

setRowHeight

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

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

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

setNodeDimensions

public void setNodeDimensions(AbstractLayoutCache.NodeDimensions nd)

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

Переопределяет:: setNodeDimensions в классе AbstractLayoutCache
Параметры:: nd — средство визуализации

setExpandedState

public void setExpandedState(TreePath path, boolean isExpanded)

Задает для пути path состояние развернутости isExpanded.

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

getExpandedState

public boolean getExpandedState(TreePath path)

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

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

getBounds

public Rectangle getBounds(TreePath path, Rectangle placeIn)

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

Указано в:: getBounds в классе AbstractLayoutCache
Параметры:: path — путь к элементу, который нужно нарисовать; placeIn — границы охватывающего прямоугольника
Возвращает:: границы охватывающего прямоугольника или null, если узел не удалось определить

getPathForRow

public TreePath getPathForRow(int row)

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

Указано в:: getPathForRow в классе AbstractLayoutCache
Параметры:: row — интересующее местоположение
Возвращает:: путь для row или null, если row не виден

getRowForPath

public int getRowForPath(TreePath path)

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

Указано в:: getRowForPath в классе AbstractLayoutCache
Параметры:: path — интересующий TreePath
Возвращает:: строку, в которой виден последний элемент пути

getRowCount

public int getRowCount()

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

Указано в:: getRowCount в классе AbstractLayoutCache
Возвращает:: количество видимых строк

invalidatePathBounds

public void invalidatePathBounds(TreePath path)

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

Указано в:: invalidatePathBounds в классе AbstractLayoutCache
Параметры:: path — TreePath, который теперь недействителен

getPreferredHeight

public int getPreferredHeight()

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

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

getPreferredWidth

public int getPreferredWidth(Rectangle bounds)

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

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

getPathClosestTo

public TreePath getPathClosestTo(int x, int y)

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

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

getVisiblePathsFrom

public Enumeration<TreePath> getVisiblePathsFrom(TreePath path)

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

Указано в:: getVisiblePathsFrom в классе AbstractLayoutCache
Параметры:: path — местоположение в TreePath, с которого начинается перебор
Возвращает:: Enumerator, перебирающий видимые пути

getVisibleChildCount

public int getVisibleChildCount(TreePath path)

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

Указано в:: getVisibleChildCount в классе AbstractLayoutCache
Параметры:: path — проверяемый путь
Возвращает:: количество видимых дочерних элементов для path

invalidateSizes

public void invalidateSizes()

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

Указано в:: invalidateSizes в классе AbstractLayoutCache

isExpanded

public boolean isExpanded(TreePath path)

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

Указано в:: isExpanded в классе AbstractLayoutCache
Параметры:: path — проверяемый TreePath
Возвращает:: true, если значение, указанное path, в данный момент развернуто

treeNodesChanged

public void treeNodesChanged(TreeModelEvent e)

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

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

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

Указано в:: treeNodesChanged в классе AbstractLayoutCache
Параметры:: e — интересующий TreeModelEvent

treeNodesInserted

public void treeNodesInserted(TreeModelEvent e)

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

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

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

Указано в:: treeNodesInserted в классе AbstractLayoutCache
Параметры:: e — интересующий TreeModelEvent

treeNodesRemoved

public void treeNodesRemoved(TreeModelEvent e)

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

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

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

Указано в:: treeNodesRemoved в классе AbstractLayoutCache
Параметры:: e — интересующий TreeModelEvent

treeStructureChanged

public void treeStructureChanged(TreeModelEvent e)

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

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

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

Указано в:: treeStructureChanged в классе AbstractLayoutCache
Параметры:: e — интересующий TreeModelEvent

© 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.