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

Параметры:: 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, 2023, 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/21/docs/api/java.desktop/javax/swing/text/TableView.html