Класс TableView

javax.swing.text.TableView

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

public abstract class TableView extends BoxView

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


    TABLE
      ROW
        CELL
        CELL
      ROW
        CELL
        CELL

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

См. также:

View

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

Модификатор и тип	Класс	Описание
`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 - заданный диапазон для общей суммы всех столбцов таблицы; reqs - требования, желаемые для каждого столбца. Это максимальный столбец минимального, предпочтительного и максимального запрошенного диапазона ячеек; spans - возвращаемое значение, указывающее, сколько нужно выделить каждому столбцу; offsets - возвращаемое значение смещения от начала для каждого столбца

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

См. также:

SizeRequirements

getViewAtPosition

protected View getViewAtPosition(int pos, Rectangle a)

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

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

© 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/text/TableView.html