Интерфейс TableColumnModel

Все известные реализующие классы:: DefaultTableColumnModel

public interface TableColumnModel

Определяет требования к объекту модели столбцов таблицы, предназначенному для использования с JTable.

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addColumn(TableColumn aColumn)`	Добавляет `aColumn` в конец массива `tableColumns`.
`void`	`addColumnModelListener(TableColumnModelListener x)`	Добавляет слушателя событий модели столбцов таблицы.
`TableColumn`	`getColumn(int columnIndex)`	Возвращает объект `TableColumn` для столбца с индексом `columnIndex`.
`int`	`getColumnCount()`	Возвращает количество столбцов в модели.
`int`	`getColumnIndex(Object columnIdentifier)`	Возвращает индекс первого столбца таблицы, идентификатор которого равен `identifier` при сравнении с помощью `equals`.
`int`	`getColumnIndexAtX(int xPosition)`	Возвращает индекс столбца, содержащего точку по горизонтали `xPosition`; или -1, если она находится за пределами всех столбцов.
`int`	`getColumnMargin()`	Возвращает ширину промежутка между ячейками каждого столбца.
`Enumeration<TableColumn>`	`getColumns()`	Возвращает `Enumeration` всех столбцов модели.
`boolean`	`getColumnSelectionAllowed()`	Возвращает true, если столбцы можно выбирать.
`int`	`getSelectedColumnCount()`	Возвращает количество выбранных столбцов.
`int[]`	`getSelectedColumns()`	Возвращает массив индексов всех выбранных столбцов.
`ListSelectionModel`	`getSelectionModel()`	Возвращает текущую модель выбора.
`int`	`getTotalColumnWidth()`	Возвращает общую ширину всех столбцов.
`void`	`moveColumn(int columnIndex, int newIndex)`	Перемещает столбец и его заголовок с позиции `columnIndex` на позицию `newIndex`.
`void`	`removeColumn(TableColumn column)`	Удаляет `TableColumn` `column` из массива `tableColumns`.
`void`	`removeColumnModelListener(TableColumnModelListener x)`	Удаляет слушателя событий модели столбцов таблицы.
`void`	`setColumnMargin(int newMargin)`	Устанавливает ширину полей столбцов `TableColumn` равной `newMargin`.
`void`	`setColumnSelectionAllowed(boolean flag)`	Устанавливает, можно ли выбирать столбцы в этой модели.
`void`	`setSelectionModel(ListSelectionModel newModel)`	Устанавливает модель выбора.

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

addColumn

void addColumn(TableColumn aColumn)

Добавляет aColumn в конец массива tableColumns. Этот метод отправляет слушателям событие columnAdded.

Параметры:

aColumn — TableColumn, который нужно добавить

См. также:

removeColumn

void removeColumn(TableColumn column)

Удаляет TableColumn column из массива tableColumns. Метод ничего не делает, если column отсутствует в списке столбцов таблицы. Этот метод отправляет слушателям событие columnRemoved.

Параметры:

column — TableColumn, который нужно удалить

См. также:

moveColumn

void moveColumn(int columnIndex, int newIndex)

Перемещает столбец и его заголовок с позиции columnIndex на позицию newIndex. Теперь прежний столбец на позиции columnIndex будет находиться на позиции newIndex. Столбец, ранее находившийся на позиции newIndex, сдвигается влево или вправо, чтобы освободить место. Столбцы не перемещаются, если columnIndex равно newIndex. Этот метод отправляет слушателям событие columnMoved.

Параметры:: columnIndex — индекс перемещаемого столбца; newIndex — индекс нового местоположения столбца
Исключения:: IllegalArgumentException — если columnIndex или newIndex не входят в допустимый диапазон

setColumnMargin

void setColumnMargin(int newMargin)

Устанавливает ширину полей столбцов TableColumn равной newMargin. Этот метод отправляет слушателям событие columnMarginChanged.

Параметры:

newMargin — ширина новых полей столбцов в пикселях

См. также:

getColumnCount

int getColumnCount()

Возвращает количество столбцов в модели.

Возвращает:: количество столбцов в модели

getColumns

Enumeration<TableColumn> getColumns()

Возвращает Enumeration всех столбцов модели.

Возвращает:: Enumeration всех столбцов модели

getColumnIndex

int getColumnIndex(Object columnIdentifier)

Возвращает индекс первого столбца таблицы, идентификатор которого равен identifier при сравнении с помощью equals.

Параметры:

columnIdentifier — объект-идентификатор

Возвращает:

индекс первого столбца таблицы, идентификатор которого равен identifier

Исключения:

IllegalArgumentException — если identifier равен null или ни один TableColumn не имеет этого identifier

См. также:

getColumn

TableColumn getColumn(int columnIndex)

Возвращает объект TableColumn для столбца с индексом columnIndex.

Параметры:: columnIndex — индекс нужного столбца
Возвращает:: объект TableColumn для столбца с индексом columnIndex

getColumnMargin

int getColumnMargin()

Возвращает ширину промежутка между ячейками каждого столбца.

Возвращает:: ширину поля в пикселях между ячейками

getColumnIndexAtX

int getColumnIndexAtX(int xPosition)

Возвращает индекс столбца, содержащего точку по горизонтали xPosition; или -1, если она находится за пределами всех столбцов. В соответствии с архитектурой Swing с разделением модели, TableColumnModel не знает, как столбцы таблицы фактически отображаются на экране. За визуальное представление столбцов отвечает объект представления/контроллера, использующий эту модель (обычно JTable). Объект представления/контроллера не обязан отображать столбцы последовательно слева направо. Например, столбцы могут отображаться справа налево с учетом языковых предпочтений, или некоторые столбцы могут быть скрыты по запросу пользователя. Поскольку модель не знает, как столбцы расположены на экране, заданное значение xPosition не следует считать координатой в двумерном графическом пространстве. Вместо этого его следует рассматривать как расстояние от начала первого столбца модели. Если требуется определить индекс столбца для заданной координаты X в двумерном пространстве, можно использовать JTable.columnAtPoint.

Параметры:

xPosition — расстояние от начала первого столбца модели.

Возвращает:

индекс столбца или -1, если столбец не найден

См. также:

getTotalColumnWidth

int getTotalColumnWidth()

Возвращает общую ширину всех столбцов.

Возвращает:: суммарную вычисленную ширину всех столбцов

setColumnSelectionAllowed

void setColumnSelectionAllowed(boolean flag)

Устанавливает, можно ли выбирать столбцы в этой модели.

Параметры:

flag — true, если столбцы можно выбирать; в противном случае false

См. также:

getColumnSelectionAllowed

boolean getColumnSelectionAllowed()

Возвращает true, если столбцы можно выбирать.

Возвращает:

true, если столбцы можно выбирать

См. также:

getSelectedColumns

int[] getSelectedColumns()

Возвращает массив индексов всех выбранных столбцов.

Возвращает:: массив целых чисел с индексами всех выбранных столбцов или пустой массив, если ничего не выбрано

getSelectedColumnCount

int getSelectedColumnCount()

Возвращает количество выбранных столбцов.

Возвращает:: количество выбранных столбцов или 0, если ни один столбец не выбран

setSelectionModel

void setSelectionModel(ListSelectionModel newModel)

Устанавливает модель выбора.

Параметры:

newModel — объект ListSelectionModel

См. также:

getSelectionModel

ListSelectionModel getSelectionModel()

Возвращает текущую модель выбора.

Возвращает:

объект ListSelectionModel

См. также:

addColumnModelListener

void addColumnModelListener(TableColumnModelListener x)

Добавляет слушателя событий модели столбцов таблицы.

Параметры:: x — объект TableColumnModelListener

removeColumnModelListener

void removeColumnModelListener(TableColumnModelListener x)

Удаляет слушателя событий модели столбцов таблицы.

Параметры:: x — объект TableColumnModelListener

© 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/table/TableColumnModel.html