Класс 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)`	Возвращает итератор, который перебирает видимые пути, начиная с заданной позиции.
`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 - истинно, если корневой узел дерева должен отображаться

См. также:

rootVisible

isRootVisible

public boolean isRootVisible()

Возвращает истинно, если корневой узел дерева отображается.

Возвращает:

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

См. также:

rootVisible

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)

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

Параметры:: 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, который перебирает видимые пути, начиная с переданного расположения. Порядок перечисления основан на том, как отображаются пути. Первый элемент возвращаемого перечисления будет путём, если только он не отображается, в этом случае возвращается null.

Параметры:: path - начальное расположение для перечисления
Возвращает:: Enumerator, начинающийся с желаемого расположения

getVisibleChildCount

public abstract int getVisibleChildCount(TreePath path)

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

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

setExpandedState

public abstract void setExpandedState(TreePath path, boolean isExpanded)

Помечает путь path состояние раскрытия на isExpanded.

Параметры:: path - путь, который должен быть раскрыт или свернут; isExpanded - истинно, если путь должен быть раскрыт, ложно в противном случае

getExpandedState

public abstract boolean getExpandedState(TreePath path)

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

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

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

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, 2021, 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/17/docs/api/java.desktop/javax/swing/tree/AbstractLayoutCache.html