Класс TableView

java.lang.Object
- javax.swing.text.View
- - javax.swing.text.CompositeView
  - - javax.swing.text.BoxView
    - - 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 если такого нет