Класс 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)

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

Параметры:: 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 - истинно, если корневой узел дерева должен быть отображен

См. также:

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 - обновляемый путь

Изменение узлов дерева

public abstract void treeNodesChanged(TreeModelEvent e)

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

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

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

Параметры:: e - the TreeModelEvent

Добавление узлов в дерево

public abstract void treeNodesInserted(TreeModelEvent e)

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

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

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

Параметры:: e - the TreeModelEvent

Удаление узлов из дерева

public abstract void treeNodesRemoved(TreeModelEvent e)

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

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

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

Параметры:: e - the TreeModelEvent

Изменение структуры дерева

public abstract void treeStructureChanged(TreeModelEvent e)

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

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

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

Параметры:: e - the TreeModelEvent

Получить строки для путей

public int[] getRowsForPaths(TreePath[] paths)

Возвращает строки, в которых отображаются экземпляры TreePath в path. Этот метод должен возвращать массив той же длины, что и переданный, и если один из экземпляров TreePaths в path недействителен, его элемент в массиве должен быть установлен в -1.

Определено в:: getRowsForPaths в интерфейсе RowMapper
Параметры:: paths - массив экземпляров TreePath для запроса
Возвращает:: массив той же длины, что и переданный, содержащий строки, в которых отображается каждый соответствующий экземпляр TreePath; если paths является null, возвращается null

Получить размеры узла

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 если у узла нет размеров

Есть ли фиксированная высота строки?

protected boolean isFixedRowHeight()

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

Возвращает:: является ли высота каждой строки фиксированной

© 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/AbstractLayoutCache.html