Интерфейс 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()`	Возвращает массив всех столбцов в модели.
`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 не найден

См. также:

getColumn

TableColumn getColumn(int columnIndex)

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

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

getColumnMargin

int getColumnMargin()

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

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

getColumnIndexAtX

int getColumnIndexAtX(int xPosition)

Возвращает индекс столбца, расположенного на горизонтальной координате xPosition; или -1, если он находится за пределами границ любого столбца. В соответствии с архитектурой Swing, TableColumnModel не знает, как столбцы таблицы отображаются на экране. Визуальное отображение столбцов является обязанностью объекта представления/контроллера, использующего эту модель (обычно JTable). Представление/контроллер не обязан отображать столбцы последовательно слева направо. Например, столбцы могут отображаться справа налево для соответствия предпочтениям локали, или некоторые столбцы могут быть скрыты по запросу пользователя. Поскольку модель не знает, как столбцы расположены на экране, указанная xPosition не должна рассматриваться как координата в 2D графическом пространстве. Вместо этого она должна рассматриваться как ширина от начала первого столбца в модели. Если требуется индекс столбца для данной координаты X в 2D пространстве, следует использовать 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/table/TableColumnModel.html