Класс VariableHeightLayoutCache

java.lang.Object

javax.swing.tree.AbstractLayoutCache

javax.swing.tree.VariableHeightLayoutCache

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

public class VariableHeightLayoutCache extends AbstractLayoutCache

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

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

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

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

AbstractLayoutCache.NodeDimensions

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

Поля, объявленные в классе javax.swing.tree.AbstractLayoutCache

nodeDimensions, rootVisible, rowHeight, treeModel, 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)`	Вызывается после того, как структура дерева кардинально изменилась от заданного узла вниз.

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

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

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

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

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

VariableHeightLayoutCache

public VariableHeightLayoutCache()

Создаёт VariableHeightLayoutCache.

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

setModel

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

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

Overrides:: setModel в классе AbstractLayoutCache
Параметры:: newModel - TreeModel, предоставляющий данные

setRootVisible

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

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

Overrides:

setRootVisible в классе AbstractLayoutCache

Параметры:

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

См. также:

setRowHeight

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

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

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

setNodeDimensions

public void setNodeDimensions(AbstractLayoutCache.NodeDimensions nd)

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

Overrides:: setNodeDimensions в классе AbstractLayoutCache
Параметры:: nd - рендерер

setExpandedState

public void setExpandedState(TreePath path, boolean isExpanded)

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

Specified by:: setExpandedState в классе AbstractLayoutCache
Параметры:: path - путь TreePath; isExpanded - true, если путь должен быть расширен, в противном случае false

getExpandedState

public boolean getExpandedState(TreePath path)

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

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

getBounds

public Rectangle getBounds(TreePath path, Rectangle placeIn)

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

Specified by:: getBounds в классе AbstractLayoutCache
Параметры:: path - путь для отрисовки; placeIn - пределы окружающего прямоугольника
Возвращает:: пределы окружающего прямоугольника или null, если узел не удалось определить

getPathForRow

public TreePath getPathForRow(int row)

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

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

getRowForPath

public int getRowForPath(TreePath path)

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

Specified by:: getRowForPath в классе AbstractLayoutCache
Параметры:: path - интересующий TreePath
Возвращает:: строку, в которой последняя запись в пути видна

getRowCount

public int getRowCount()

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

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

invalidatePathBounds

public void invalidatePathBounds(TreePath path)

Инструктирует LayoutCache, что пределы path недействительны и должны быть обновлены.

Specified by:: invalidatePathBounds в классе AbstractLayoutCache
Параметры:: path - TreePath, который сейчас недействителен

getPreferredHeight

public int getPreferredHeight()

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

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

getPreferredWidth

public int getPreferredWidth(Rectangle bounds)

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

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

getPathClosestTo

public TreePath getPathClosestTo(int x, int y)

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

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

getVisiblePathsFrom

public Enumeration<TreePath> getVisiblePathsFrom(TreePath path)

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

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

getVisibleChildCount

public int getVisibleChildCount(TreePath path)

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

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

invalidateSizes

public void invalidateSizes()

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

Specified by:: invalidateSizes в классе AbstractLayoutCache

isExpanded

public boolean isExpanded(TreePath path)

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

Specified by:: isExpanded в классе AbstractLayoutCache
Параметры:: path - проверяемый TreePath
Возвращает:: true, если значение, идентифицированное path, в настоящее время расширено

treeNodesChanged

public void treeNodesChanged(TreeModelEvent e)

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

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

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

Specified by:: treeNodesChanged в классе AbstractLayoutCache
Параметры:: e - интересующий TreeModelEvent

treeNodesInserted

public void treeNodesInserted(TreeModelEvent e)

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

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

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

Specified by:: treeNodesInserted in class AbstractLayoutCache
Parameters:: e - the TreeModelEvent интересующего узла

treeNodesRemoved

public void treeNodesRemoved(TreeModelEvent e)

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

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

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

Specified by:: treeNodesRemoved in class AbstractLayoutCache
Parameters:: e - the TreeModelEvent интересующего узла

treeStructureChanged

public void treeStructureChanged(TreeModelEvent e)

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

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

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

Specified by:: treeStructureChanged in class AbstractLayoutCache
Parameters:: e - the 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/tree/VariableHeightLayoutCache.html