Класс TableView

javax.swing.text.TableView

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

public abstract class TableView extends BoxView

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


   TABLE
     ROW
       CELL
       CELL
     ROW
       CELL
       CELL

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

См. также:

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

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

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

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

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Поля, объявленные в интерфейсе 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; их следует создавать с помощью ViewFactory, а не таблицы.
`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)`	Изменяет дочерние представления.

Методы, объявленные в классе 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

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

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

Методы, объявленные в классе 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

Методы, объявленные в классе 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; их следует создавать с помощью ViewFactory, а не таблицы.

Параметры:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/TableView.html