Класс TableView

javax.swing.text.TableView

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

public abstract class TableView extends BoxView

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


   TABLE
     ROW
       CELL
       CELL
     ROW
       CELL
       CELL

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

См. также:

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

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

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

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

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Модификатор и тип	Поле	Описание
`static final int`	`BadBreakWeight`	Вес, указывающий, что представление является неудачным местом для разрыва при форматировании.
`static final int`	`ExcellentBreakWeight`	Вес, указывающий, что представление поддерживает разбиение и является очень подходящим местом для разрыва.
`static final int`	`ForcedBreakWeight`	Вес, указывающий, что представление поддерживает разбиение и должно быть разбито для корректного отображения в представлении, форматирующем дочерние элементы путём разбиения.
`static final int`	`GoodBreakWeight`	Вес, указывающий, что представление поддерживает разбиение, но, вероятно, существуют более подходящие места.
`static final int`	`X_AXIS`	Ось для операций форматирования и разбиения.
`static final int`	`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

Модификатор и тип	Поле	Описание
`static final int`	`BOTTOM`	Константа ориентации блока, используемая для указания его нижней стороны.
`static final int`	`CENTER`	Центральная позиция в области.
`static final int`	`EAST`	Направление по компасу: восток (справа).
`static final int`	`HORIZONTAL`	Горизонтальная ориентация.
`static final int`	`LEADING`	Обозначает передний край текста для языков с письмом слева направо и справа налево.
`static final int`	`LEFT`	Константа ориентации блока, используемая для указания его левой стороны.
`static final int`	`NEXT`	Обозначает следующее направление в последовательности.
`static final int`	`NORTH`	Направление по компасу: север (сверху).
`static final int`	`NORTH_EAST`	Направление по компасу: северо-восток (сверху справа).
`static final int`	`NORTH_WEST`	Направление по компасу: северо-запад (сверху слева).
`static final int`	`PREVIOUS`	Обозначает предыдущее направление в последовательности.
`static final int`	`RIGHT`	Константа ориентации блока, используемая для указания его правой стороны.
`static final int`	`SOUTH`	Направление по компасу: юг (снизу).
`static final int`	`SOUTH_EAST`	Направление по компасу: юго-восток (снизу справа).
`static final int`	`SOUTH_WEST`	Направление по компасу: юго-запад (снизу слева).
`static final int`	`TOP`	Константа ориентации блока, используемая для указания его верхней стороны.
`static final int`	`TRAILING`	Обозначает задний край текста для языков с письмом слева направо и справа налево.
`static final int`	`VERTICAL`	Вертикальная ориентация.
`static final int`	`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

Модификатор и тип	Метод	Описание
`protected void`	`baselineLayout(int targetSpan, int axis, int[] offsets, int[] spans)`	Вычисляет положение и размер каждого дочернего представления в этом `BoxView` с учётом `targetSpan`, то есть ширины (или высоты) доступной области.
`protected SizeRequirements`	`baselineRequirements(int axis, SizeRequirements r)`	Вычисляет требования к размеру этого `BoxView`, анализируя размер каждого дочернего представления.
`protected SizeRequirements`	`calculateMajorAxisRequirements(int axis, SizeRequirements r)`	Вычисляет требования к размеру по главной оси `axis`.
`protected void`	`childAllocation(int index, Rectangle alloc)`	Выделяет область для дочернего представления.
`protected boolean`	`flipEastAndWestAtEnds(int position, Position.Bias bias)`	Определяет направление расположения следующего представления.
`protected void`	`forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)`	Передаёт указанный `DocumentEvent` дочерним представлениям, которые необходимо уведомить об изменении модели.
`float`	`getAlignment(int axis)`	Определяет желаемое выравнивание этого представления вдоль оси.
`int`	`getAxis()`	Возвращает свойство оси размещения элементов.
`Shape`	`getChildAllocation(int index, Shape a)`	Возвращает область, выделенную для указанного дочернего представления.
`int`	`getHeight()`	Возвращает текущую высоту блока.
`float`	`getMaximumSpan(int axis)`	Определяет максимальный размер этого представления вдоль оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальный размер этого представления вдоль оси.
`protected int`	`getOffset(int axis, int childIndex)`	Возвращает смещение текущей компоновки указанного дочернего представления.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительный размер этого представления вдоль оси.
`int`	`getResizeWeight(int axis)`	Возвращает вес изменения размера.
`protected int`	`getSpan(int axis, int childIndex)`	Возвращает размер текущей компоновки указанного дочернего представления.
`protected View`	`getViewAtPoint(int x, int y, Rectangle alloc)`	Возвращает дочернее представление в указанных координатах.
`int`	`getWidth()`	Возвращает текущую ширину блока.
`protected boolean`	`isAfter(int x, int y, Rectangle innerAlloc)`	Определяет, находится ли точка за пределами выделенной области.
`protected boolean`	`isAllocationValid()`	Остаются ли выделенные области дочерних элементов действительными?
`protected boolean`	`isBefore(int x, int y, Rectangle innerAlloc)`	Определяет, находится ли точка перед выделенной областью.
`protected boolean`	`isLayoutValid(int axis)`	Определяет, является ли компоновка действительной вдоль указанной оси.
`protected void`	`layout(int width, int height)`	Выполняет компоновку блока
`void`	`layoutChanged(int axis)`	Помечает компоновку вдоль оси как недействительную.
`protected void`	`layoutMajorAxis(int targetSpan, int axis, int[] offsets, int[] spans)`	Выполняет компоновку блока по главной оси (то есть по представляемой им оси).
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Обеспечивает преобразование из координатного пространства модели документа в координатное пространство соответствующего ей представления.
`void`	`paint(Graphics g, Shape allocation)`	Отображает `BoxView` с помощью указанной поверхности и области на этой поверхности.
`protected void`	`paintChild(Graphics g, Rectangle alloc, int index)`	Рисует дочерний элемент.
`void`	`preferenceChanged(View child, boolean width, boolean height)`	Вызывается дочерним элементом, чтобы сообщить об изменении его предпочтительного размера.
`void`	`setAxis(int axis)`	Задаёт свойство оси размещения элементов.
`void`	`setSize(float width, float height)`	Задаёт размер представления.
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] bias)`	Обеспечивает преобразование из координатного пространства представления в логическое координатное пространство модели.

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

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

Модификатор и тип	Метод	Описание
`protected short`	`getBottomInset()`	Возвращает нижний внутренний отступ.
`protected Rectangle`	`getInsideAllocation(Shape a)`	Преобразует неизменяемую область, выделенную представлению, в изменяемую область, представляющую внутреннюю область (то есть границы указанной области с исключёнными верхним, левым, нижним и правым внутренними отступами).
`protected short`	`getLeftInset()`	Возвращает левый внутренний отступ.
`protected int`	`getNextEastWestVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Возвращает следующую визуальную позицию курсора в восточном или западном направлении.
`protected int`	`getNextNorthSouthVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Возвращает следующую визуальную позицию курсора в северном или южном направлении.
`int`	`getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Позволяет определить следующее визуально представленное положение модели, в котором можно разместить каретку.
`protected short`	`getRightInset()`	Возвращает правый внутренний отступ.
`protected short`	`getTopInset()`	Возвращает верхний внутренний отступ.
`View`	`getView(int n)`	Возвращает n-е представление в этом контейнере.
`int`	`getViewCount()`	Возвращает количество дочерних представлений этого представления.
`int`	`getViewIndex(int pos, Position.Bias b)`	Возвращает индекс дочернего представления, соответствующего указанной позиции в модели.
`protected int`	`getViewIndexAtPosition(int pos)`	Возвращает индекс дочернего представления, соответствующего указанной позиции в модели.
`protected void`	`loadChildren(ViewFactory f)`	Загружает все дочерние элементы для инициализации представления.
`Shape`	`modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a)`	Обеспечивает преобразование из координатного пространства модели документа в координатное пространство соответствующего ей представления.
`protected void`	`setInsets(short top, short left, short bottom, short right)`	Задаёт внутренние отступы представления.
`protected void`	`setParagraphInsets(AttributeSet attr)`	Задаёт внутренние отступы на основе атрибутов абзаца, указанных в заданных атрибутах.
`void`	`setParent(View parent)`	Задаёт родительское представление.

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

Модификатор и тип	Метод	Описание
`void`	`append(View v)`	Добавляет одно дочернее представление.
`View`	`breakView(int axis, int offset, float pos, float len)`	Пытается выполнить разбиение этого представления по указанной оси.
`void`	`changedUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Получает уведомление от документа об изменении атрибутов в области, за которую отвечает это представление.
`View`	`createFragment(int p0, int p1)`	Создаёт представление, отображающее часть элемента.
`protected void`	`forwardUpdateToView(View v, DocumentEvent e, Shape a, ViewFactory f)`	Передаёт `DocumentEvent` указанному дочернему представлению.
`AttributeSet`	`getAttributes()`	Возвращает атрибуты, используемые при отображении.
`int`	`getBreakWeight(int axis, float pos, float len)`	Определяет, насколько удачно это представление подходит для разрыва.
`Container`	`getContainer()`	Возвращает контейнер, в котором размещено представление.
`Document`	`getDocument()`	Возвращает модель, связанную с представлением.
`Element`	`getElement()`	Возвращает структурную часть объекта, с которой сопоставлено это представление.
`int`	`getEndOffset()`	Возвращает часть модели, за которую отвечает это представление.
`Graphics`	`getGraphics()`	Возвращает `Graphics` для отображения.
`View`	`getParent()`	Возвращает родительское представление.
`int`	`getStartOffset()`	Возвращает часть модели, за которую отвечает это представление.
`String`	`getToolTipText(float x, float y, Shape allocation)`	Возвращает текст всплывающей подсказки в указанном месте.
`ViewFactory`	`getViewFactory()`	Возвращает реализацию `ViewFactory`, обеспечивающую иерархию представлений.
`int`	`getViewIndex(float x, float y, Shape allocation)`	Возвращает индекс дочернего представления, соответствующего указанной позиции в представлении.
`void`	`insert(int offs, View v)`	Вставляет одно дочернее представление.
`void`	`insertUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Получает уведомление о вставке данных в документ в области, за которую отвечает это представление.
`boolean`	`isVisible()`	Возвращает логическое значение, указывающее, видно ли представление.
`Shape`	`modelToView(int pos, Shape a)`	Устарело.
`void`	`remove(int i)`	Удаляет дочерний элемент в указанной позиции.
`void`	`removeAll()`	Удаляет все дочерние элементы.
`void`	`removeUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Получает уведомление об удалении данных из документа в области, за которую отвечает это представление.
`protected boolean`	`updateChildren(DocumentEvent.ElementChange ec, DocumentEvent e, ViewFactory f)`	Обновляет дочерние представления после получения уведомления об изменении модели, если запись об изменении относится к элементу, за который отвечает это представление.
`protected void`	`updateLayout(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a)`	Обновляет компоновку после получения уведомления об изменении модели.
`int`	`viewToModel(float x, float y, Shape a)`	Устарело.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API будет удалён в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в ожидание до пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в ожидание до пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в ожидание до пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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.