Класс 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 в классе AbstractLayoutCache
Параметры:: e - TreeModelEvent, представляющий интерес

treeNodesRemoved

public void treeNodesRemoved(TreeModelEvent e)

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

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

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

Specified by:: treeNodesRemoved в классе AbstractLayoutCache
Parameters:: e - TreeModelEvent объекта

treeStructureChanged

public void treeStructureChanged(TreeModelEvent e)

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

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

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

Specified by:: treeStructureChanged в классе AbstractLayoutCache
Parameters:: e - TreeModelEvent объекта

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/tree/VariableHeightLayoutCache.html