Класс 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 Используется |
Поля
| Модификатор и тип | Поле и описание |
|---|---|
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) Возвращает true, если путь развернут и виден. |
TreeModel |
getModel() Возвращает |
AbstractLayoutCache.NodeDimensions |
getNodeDimensions() Возвращает объект, отображающий узлы в дереве, и который отвечает за вычисление размеров отдельных узлов. |
protected Rectangle |
getNodeDimensions(Object value,
int row,
int depth,
boolean expanded,
Rectangle placeIn) Возвращает, по ссылке в |
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) Возвращает строки, в которых отображаются экземпляры |
TreeSelectionModel |
getSelectionModel() Возвращает модель, используемую для управления выбором. |
abstract int |
getVisibleChildCount(TreePath path) Возвращает количество видимых дочерних элементов для строки. |
abstract Enumeration<TreePath> |
getVisiblePathsFrom(TreePath path) Возвращает итератор, переходящий по видимым путям, начиная с указанного расположения. |
abstract void |
invalidatePathBounds(TreePath path) Указывает |
abstract void |
invalidateSizes() Информирует |
abstract boolean |
isExpanded(TreePath path) Возвращает true, если значение, идентифицируемое строкой, в настоящее время развернуто. |
protected boolean |
isFixedRowHeight() Возвращает true, если высота каждой строки имеет фиксированный размер. |
boolean |
isRootVisible() Возвращает true, если корневой узел дерева отображается. |
abstract void |
setExpandedState(TreePath path,
boolean isExpanded) Устанавливает состояние развернутости пути |
void |
setModel(TreeModel newModel) Устанавливает |
void |
setNodeDimensions(AbstractLayoutCache.NodeDimensions nd) Устанавливает рендерер, ответственный за отображение узлов в дереве и, следовательно, за вычисление размеров отдельных узлов. |
void |
setRootVisible(boolean rootVisible) Определяет, отображается ли или нет корневой узел из |
void |
setRowHeight(int rowHeight) Устанавливает высоту каждой ячейки. |
void |
setSelectionModel(TreeSelectionModel newLSM) Устанавливает |
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
public void setRootVisible(boolean rootVisible)
Определяет, отображается ли корневой узел из TreeModel.
- Параметры:
-
rootVisible- истинно, если корневой узел дерева должен быть отображен - См. также:
rootVisible
isRootVisible
public boolean isRootVisible()
Возвращает истинно, если корневой узел дерева отображается.
- Возвращает:
- истинно, если корневой узел дерева отображается
- См. также:
rootVisible
setRowHeight
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)
Возвращает истинно, если значение, определенное строкой, в настоящее время раскрыто.
getBounds
public abstract Rectangle getBounds(TreePath path,
Rectangle placeIn) Возвращает прямоугольник, задающий границы, необходимые для отрисовки пути.
- Параметры:
-
path- путь, определяющий узел -
placeIn- объект, предоставляющий доступное пространство - Возвращает:
- объект, определяющий используемое пространство
getPathForRow
public abstract TreePath getPathForRow(int row)
Возвращает путь для переданной строки. Если строка не отображается, возвращается null
- Параметры:
-
row- запрашиваемая строка - Возвращает:
- путь для данной строки
getRowForPath
public abstract int getRowForPath(TreePath path)
Возвращает строку, в которой последний элемент, определенный в пути, отображается. Вернет -1, если какой-либо из элементов в пути в настоящее время не отображается.
- Параметры:
-
path- запрашиваемый путь - Возвращает:
- строка, где последний элемент в пути отображается, или -1, если какие-либо элементы в пути в настоящее время не отображаются
getPathClosestTo
public abstract TreePath getPathClosestTo(int x,
int y) Возвращает путь к узлу, который наиболее близок к x, y. Если ничего в настоящее время не отображается, возвращается null, в противном случае всегда возвращается допустимый путь. Если вам нужно проверить, находится ли возвращаемый объект точно в x, y, вы должны получить границы для возвращаемого пути и проверить x, y по отношению к ним.
- Параметры:
-
x- горизонтальная компонента желаемого местоположения -
y- вертикальная компонента желаемого местоположения - Возвращает:
- путь, ближайший к указанной точке
getVisiblePathsFrom
public abstract Enumeration<TreePath> getVisiblePathsFrom(TreePath path)
Возвращает Enumerator, который перебирает видимые пути, начиная с указанного местоположения. Порядок перечисления основан на том, как отображаются пути. Первый элемент возвращаемого перечисления будет path, если он не отображается, тогда будет возвращен null
- Параметры:
-
path- начальная точка для перечисления - Возвращает:
- перечисление, начинающееся с желаемого местоположения
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- обновляемый путь
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-Rectangleсодержащий размер, необходимый для представленияvalue - Возвращает:
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.