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

См. также:

AbstractLayoutCache.rootVisible

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, 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/VariableHeightLayoutCache.html