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

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

protected int rowHeight

Высота, используемая для каждой строки.

protected TreeModel treeModel

Модель, предоставляющая информацию.

protected TreeSelectionModel treeSelectionModel

Модель выбора.

Конструкторы

Конструктор Описание
AbstractLayoutCache()

Методы

Модификатор и тип Метод Описание
abstract Rectangle getBounds​(TreePath path, Rectangle placeIn)

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

abstract boolean getExpandedState​(TreePath path)

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

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)

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

protected boolean isFixedRowHeight()

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

boolean isRootVisible()

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

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

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

isRootVisible

public boolean isRootVisible()

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

Возвращает:
true, если корневой узел дерева отображается
См. также:
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)

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

treeNodesChanged

public abstract void treeNodesChanged(TreeModelEvent e)

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

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

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

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

treeNodesInserted

public abstract void treeNodesInserted(TreeModelEvent e)

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

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

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

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

treeNodesRemoved

public abstract void treeNodesRemoved(TreeModelEvent e)

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

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

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

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

treeStructureChanged

public abstract void treeStructureChanged(TreeModelEvent e)

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

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

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

Параметры:
e - 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 - a Rectangle, содержащий размер, необходимый для представления value
Возвращает:
a Rectangle, содержащий размеры узла, или null, если у узла нет размеров

isFixedRowHeight

protected boolean isFixedRowHeight()

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

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

© 1993, 2020, 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/11/docs/api/java.desktop/javax/swing/tree/AbstractLayoutCache.html

Spec-Zone .ru
спецификации, руководства, описания, API