Класс TableView

javax.swing.text.TableView

Все реализованные интерфейсы:: SwingConstants

public abstract class TableView extends BoxView

Реализует интерфейс View для таблицы, которая состоит из структуры элементов, где дочерние элементы элемента, за который отвечает этот вид, представляют собой строки, а дочерние элементы элементов строки — ячейки. Элементы ячеек могут иметь произвольную структуру элементов под ними, которая будет построена с помощью фабрики View, возвращаемой методом getViewFactory.


    TABLE
      ROW
        CELL
        CELL
      ROW
        CELL
        CELL

Это реализуется как иерархия ящиков: сама таблица — вертикальный ящик, строки — горизонтальные ящики, а ячейки — вертикальные ящики. Ячейки могут занимать несколько столбцов и строк. По умолчанию таблица может быть представлена как сформированная на сетке (т. е. примерно так, как можно найти в макете gridbag), где ячейки таблицы могут запросить занимать более одной ячейки сетки. По умолчанию горизонтальный размах ячеек таблицы будет основан на этой сетке, но может быть изменен путем повторной реализации запрошенного размаха ячейки (т. е. ячейки таблицы могут иметь независимые размахи, если это необходимо).

См. также:

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

Модификатор и тип	Класс	Описание
`class`	`TableView.TableCell`	Устарело. Ячейка таблицы теперь может быть любой реализацией View.
`class`	`TableView.TableRow`	Вид строки в таблице, ориентированной на строки.

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

Поля, объявленные в классе javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Поля, объявленные в интерфейсе javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

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

Конструктор	Описание
`TableView(Element elem)`	Создаёт TableView для данного элемента.

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

Модификатор и тип	Метод	Описание
`protected SizeRequirements`	`calculateMinorAxisRequirements(int axis, SizeRequirements r)`	Вычисление требований к малой оси.
`protected TableView.TableCell`	`createTableCell(Element elem)`	Устарело. Ячейки таблицы теперь могут быть любой произвольной реализацией View и должны быть созданы фабрикой View, а не таблицей.
`protected TableView.TableRow`	`createTableRow(Element elem)`	Создаёт новую строку таблицы.
`protected View`	`getViewAtPosition(int pos, Rectangle a)`	Извлекает дочерний вид, представляющий заданную позицию в модели.
`protected void`	`layoutColumns(int targetSpan, int[] offsets, int[] spans, SizeRequirements[] reqs)`	Выравнивание столбцов для размещения в заданном целевом размахе.
`protected void`	`layoutMinorAxis(int targetSpan, int axis, int[] offsets, int[] spans)`	Выполнение выравнивания для малой оси ящика (т. е. оси, перпендикулярной оси, которую он представляет).
`void`	`replace(int offset, int length, View[] views)`	Изменение дочерних представлений.

Методы, объявленные в классе javax.swing.text.BoxView

baselineLayout, baselineRequirements, calculateMajorAxisRequirements, childAllocation, flipEastAndWestAtEnds, forwardUpdate, getAlignment, getAxis, getChildAllocation, getHeight, getMaximumSpan, getMinimumSpan, getOffset, getPreferredSpan, getResizeWeight, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layout, layoutChanged, layoutMajorAxis, modelToView, paint, paintChild, preferenceChanged, setAxis, setSize, viewToModel

Методы, объявленные в классе javax.swing.text.CompositeView

getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewCount, getViewIndex, getViewIndexAtPosition, loadChildren, modelToView, setInsets, setParagraphInsets, setParent

Методы, объявленные в классе javax.swing.text.View

append, breakView, changedUpdate, createFragment, forwardUpdateToView, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, insertUpdate, isVisible, modelToView, remove, removeAll, removeUpdate, updateChildren, updateLayout, viewToModel

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

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

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

TableView

public TableView(Element elem)

Создаёт TableView для заданного элемента.

Параметры:: elem - элемент, за который отвечает этот вид

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

createTableRow

protected TableView.TableRow createTableRow(Element elem)

Создаёт новую строку таблицы.

Параметры:: elem - элемент
Возвращает:: строку

createTableCell

@Deprecated protected TableView.TableCell createTableCell(Element elem)

Устарело.

Ячейки таблицы теперь могут быть любыми реализациями View и должны создаваться фабрикой View, а не таблицей.

Параметры:: elem - элемент
Возвращает:: ячейку

replace

public void replace(int offset, int length, View[] views)

Изменяет дочерние представления. Это реализовано для обеспечения поведения суперкласса и для аннулирования сетки, чтобы строки и столбцы были пересчитаны.

Переопределяет:: replace в классе BoxView
Параметры:: offset - начальный индекс в дочерних представлениях для вставки новых представлений; должно быть значение >= 0 и <= getViewCount; length - количество существующих дочерних представлений для удаления; должно быть значение >= 0 и <= (getViewCount() - offset); views - дочерние представления для добавления; это значение может быть null, чтобы указать, что дочерние элементы не добавляются (полезно для удаления)

layoutColumns

protected void layoutColumns(int targetSpan, int[] offsets, int[] spans, SizeRequirements[] reqs)

Выравнивает столбцы, чтобы они вписались в заданный диапазон. Результаты возвращаются через offsets и spans.

Параметры:: targetSpan - заданный диапазон для всех столбцов таблицы; offsets - возвращаемое значение смещения от начала для каждого столбца; spans - возвращаемое значение того, сколько выделить для каждого столбца; reqs - требования, желаемые для каждого столбца. Это максимальное значение столбца для минимального, предпочтительного и максимального запрошенного размаха ячеек

layoutMinorAxis

protected void layoutMinorAxis(int targetSpan, int axis, int[] offsets, int[] spans)

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

Эта реализация вызывает метод layoutColumns, а затем передает управление суперклассу для фактического выравнивания строк таблицы.

Переопределяет:: layoutMinorAxis в классе BoxView
Параметры:: targetSpan - общий диапазон, заданный для представления, который будет использован для выравнивания дочерних элементов.; axis - выравниваемая ось.; offsets - смещения от начала представления для каждого из дочерних представлений. Это возвращаемое значение, и оно заполняется реализацией этого метода.; spans - диапазон каждого дочернего представления. Это возвращаемое значение, и оно заполняется реализацией этого метода.

calculateMinorAxisRequirements

protected SizeRequirements calculateMinorAxisRequirements(int axis, SizeRequirements r)

Вычисляет требования для малой оси. Это вызывается суперклассом всякий раз, когда необходимо обновить требования (например, через это представление было отправлено событие preferenceChanged).

Эта реализация вычисляет требования как сумму требований столбцов.

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

calculateMinorAxisRequirements в классе BoxView

Параметры:

axis - изучаемая ось

r - объект SizeRequirements; если null, будет создан новый

Возвращает:

новый инициализированный объект SizeRequirements

См. также:

getViewAtPosition

protected View getViewAtPosition(int pos, Rectangle a)

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

Переопределяет:: getViewAtPosition в классе CompositeView
Параметры:: pos - позиция поиска >= 0; a - выделение таблицы при входе и выделение представления, содержащего позицию, при выходе
Возвращает:: представление, соответствующее заданной позиции, или null, если такого нет

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/TableView.html