Класс FixedHeightLayoutCache

java.lang.Object

javax.swing.tree.AbstractLayoutCache

javax.swing.tree.FixedHeightLayoutCache

Все реализуемые интерфейсы:: RowMapper

public class FixedHeightLayoutCache extends AbstractLayoutCache

ПРИМЕЧАНИЕ: В будущем выпуске этот класс станет более открытым.

Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долговременного хранения всех JavaBeans добавлена в пакет java.beans. См. XMLEncoder.

Краткое описание вложенных классов

Вложенные классы и интерфейсы, объявленные в классе AbstractLayoutCache

AbstractLayoutCache.NodeDimensions

Модификатор и тип	Класс	Описание
`static class`	`AbstractLayoutCache.NodeDimensions`	Используется классом `AbstractLayoutCache` для определения размера и координаты x начала конкретного узла.

Краткое описание полей

Поля, объявленные в классе AbstractLayoutCache

nodeDimensions, rootVisible, rowHeight, treeModel, treeSelectionModel

Модификатор и тип	Поле	Описание
`protected AbstractLayoutCache.NodeDimensions`	`nodeDimensions`	Объект, отвечающий за получение размера узла.
`protected boolean`	`rootVisible`	Значение true, если отображается корневой узел, и false, если наивысшими видимыми узлами являются его дочерние узлы.
`protected int`	`rowHeight`	Высота каждой строки.
`protected TreeModel`	`treeModel`	Модель, предоставляющая информацию.
`protected TreeSelectionModel`	`treeSelectionModel`	Модель выбора.

Краткое описание конструкторов

Конструктор	Описание
`FixedHeightLayoutCache()`	Создает `FixedHeightLayoutCache`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Rectangle`	`getBounds(TreePath path, Rectangle placeIn)`	Возвращает прямоугольник с границами, необходимыми для отрисовки пути.
`boolean`	`getExpandedState(TreePath path)`	Возвращает true, если путь раскрыт и видим.
`TreePath`	`getPathClosestTo(int x, int y)`	Возвращает путь к узлу, ближайшему к координатам x,y.
`TreePath`	`getPathForRow(int row)`	Возвращает путь для переданной строки.
`int`	`getRowCount()`	Возвращает количество видимых строк.
`int`	`getRowForPath(TreePath path)`	Возвращает строку, в которой виден последний элемент, указанный в пути.
`int`	`getVisibleChildCount(TreePath path)`	Возвращает количество видимых дочерних узлов строки.
`Enumeration<TreePath>`	`getVisiblePathsFrom(TreePath path)`	Возвращает перечислитель, проходящий по видимым путям, начиная с переданного расположения.
`void`	`invalidatePathBounds(TreePath path)`	Ничего не делает: FixedHeightLayoutCache не кэширует ширину, а измениться может только она.
`void`	`invalidateSizes()`	Сообщает TreeState, что необходимо пересчитать все используемые размеры.
`boolean`	`isExpanded(TreePath path)`	Возвращает true, если значение, определяемое строкой, в данный момент раскрыто.
`void`	`setExpandedState(TreePath path, boolean isExpanded)`	Устанавливает состояние раскрытия пути `path` в значение `isExpanded`.
`void`	`setModel(TreeModel newModel)`	Задает TreeModel, которая будет предоставлять данные.
`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)`	Вызывается после существенного изменения структуры дерева, начиная с указанного узла.

Методы, объявленные в классе AbstractLayoutCache

getModel, getNodeDimensions, getNodeDimensions, getPreferredHeight, getPreferredWidth, getRowHeight, getRowsForPaths, getSelectionModel, isFixedRowHeight, isRootVisible, setNodeDimensions, setSelectionModel

Модификатор и тип	Метод	Описание
`TreeModel`	`getModel()`	Возвращает `TreeModel`, предоставляющую данные.
`AbstractLayoutCache.NodeDimensions`	`getNodeDimensions()`	Возвращает объект, отображающий узлы дерева и отвечающий за вычисление размеров отдельных узлов.
`protected Rectangle`	`getNodeDimensions(Object value, int row, int depth, boolean expanded, Rectangle placeIn)`	Возвращает по ссылке в `placeIn` размер, необходимый для представления `value`.
`int`	`getPreferredHeight()`	Возвращает предпочтительную высоту.
`int`	`getPreferredWidth(Rectangle bounds)`	Возвращает предпочтительную ширину для переданной области.
`int`	`getRowHeight()`	Возвращает высоту каждой строки.
`int[]`	`getRowsForPaths(TreePath[] paths)`	Возвращает строки, в которых отображаются экземпляры `TreePath` из `path`.
`TreeSelectionModel`	`getSelectionModel()`	Возвращает модель, используемую для управления выбором.
`protected boolean`	`isFixedRowHeight()`	Возвращает true, если высота каждой строки имеет фиксированное значение.
`boolean`	`isRootVisible()`	Возвращает true, если корневой узел дерева отображается.
`void`	`setNodeDimensions(AbstractLayoutCache.NodeDimensions nd)`	Задает средство отображения, отвечающее за отрисовку узлов дерева и, следовательно, за вычисление размеров отдельных узлов.
`void`	`setSelectionModel(TreeSelectionModel newLSM)`	Задает `TreeSelectionModel`, используемую для управления выбором, на новую LSM.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в будущем выпуске.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

FixedHeightLayoutCache

public FixedHeightLayoutCache()

Создает FixedHeightLayoutCache.

Подробное описание методов

setModel

public void setModel(TreeModel newModel)

Задает TreeModel, которая будет предоставлять данные.

Переопределяет:: setModel в классе AbstractLayoutCache
Параметры:: newModel — TreeModel, которая должна предоставлять данные

setRootVisible

public void setRootVisible(boolean rootVisible)

Определяет, виден ли корневой узел из TreeModel.

Переопределяет:

setRootVisible в классе AbstractLayoutCache

Параметры:

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

См. также:

setRowHeight

public void setRowHeight(int rowHeight)

Задает высоту каждой ячейки. Если rowHeight меньше или равен 0, будет выброшено исключение IllegalArgumentException.

Переопределяет:: setRowHeight в классе AbstractLayoutCache
Параметры:: rowHeight — высота каждой ячейки в пикселях

getRowCount

public int getRowCount()

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

Определен в:: getRowCount в классе AbstractLayoutCache
Возвращает:: количество отображаемых строк

invalidatePathBounds

public void invalidatePathBounds(TreePath path)

Ничего не делает: FixedHeightLayoutCache не кэширует ширину, а измениться может только она.

Определен в:: invalidatePathBounds в классе AbstractLayoutCache
Параметры:: path — обновляемый путь

invalidateSizes

public void invalidateSizes()

Сообщает TreeState, что необходимо пересчитать все используемые размеры.

Определен в:: invalidateSizes в классе AbstractLayoutCache

isExpanded

public boolean isExpanded(TreePath path)

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

Определен в:: isExpanded в классе AbstractLayoutCache
Параметры:: path — TreePath для проверки
Возвращает:: раскрыт ли TreePath

getBounds

public Rectangle getBounds(TreePath path, Rectangle placeIn)

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

Определен в:: getBounds в классе AbstractLayoutCache
Параметры:: path — TreePath, задающий узел; placeIn — объект Rectangle, задающий доступное пространство
Возвращает:: объект Rectangle, задающий используемое пространство

getPathForRow

public TreePath getPathForRow(int row)

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

Определен в:: getPathForRow в классе AbstractLayoutCache
Параметры:: row — проверяемая строка
Возвращает:: TreePath для заданной строки

getRowForPath

public int getRowForPath(TreePath path)

Возвращает строку, в которой виден последний элемент, указанный в пути. Возвращает -1, если какой-либо элемент пути в данный момент не виден.

Определен в:: getRowForPath в классе AbstractLayoutCache
Параметры:: path — проверяемый TreePath
Возвращает:: строку, в которой виден последний элемент пути, или -1, если какой-либо элемент пути в данный момент не виден

getPathClosestTo

public TreePath getPathClosestTo(int x, int y)

Возвращает путь к узлу, ближайшему к координатам x,y. Если в данный момент ничего не видно, возвращается null; в противном случае всегда возвращается допустимый путь. Чтобы проверить, находится ли возвращенный объект точно в точке x, y, получите границы возвращенного пути и сравните с ними координаты x, y.

Определен в:: getPathClosestTo в классе AbstractLayoutCache
Параметры:: x — горизонтальная координата желаемого расположения; y — вертикальная координата желаемого расположения
Возвращает:: TreePath, ближайший к указанной точке

getVisibleChildCount

public int getVisibleChildCount(TreePath path)

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

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

getVisiblePathsFrom

public Enumeration<TreePath> getVisiblePathsFrom(TreePath path)

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

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

setExpandedState

public void setExpandedState(TreePath path, boolean isExpanded)

Устанавливает состояние раскрытия пути path в значение isExpanded.

Определен в:: setExpandedState в классе AbstractLayoutCache
Параметры:: path — раскрываемый или сворачиваемый путь; isExpanded — true, если путь следует раскрыть, иначе false

getExpandedState

public boolean getExpandedState(TreePath path)

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

Определен в:: getExpandedState в классе AbstractLayoutCache
Параметры:: path — проверяемый путь
Возвращает:: true, если путь раскрыт и видим, иначе false

treeNodesChanged

public void treeNodesChanged(TreeModelEvent e)

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

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

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

Определен в:: treeNodesChanged в классе AbstractLayoutCache
Параметры:: e — TreeModelEvent

treeNodesInserted

public void treeNodesInserted(TreeModelEvent e)

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

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

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

Определен в:: treeNodesInserted в классе AbstractLayoutCache
Параметры:: e — TreeModelEvent

treeNodesRemoved

public void treeNodesRemoved(TreeModelEvent e)

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

e.path() возвращает бывший родительский узел удаленных узлов.

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

Определен в:: treeNodesRemoved в классе AbstractLayoutCache
Параметры:: e — TreeModelEvent

treeStructureChanged

public void treeStructureChanged(TreeModelEvent e)

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

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

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

Определен в:: treeStructureChanged в классе AbstractLayoutCache
Параметры:: e — TreeModelEvent

© 1993, 2025, 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.