Класс DefaultTableColumnModel

java.lang.Object

javax.swing.table.DefaultTableColumnModel

Все реализуемые интерфейсы:: PropertyChangeListener, Serializable, EventListener, ListSelectionListener, TableColumnModel

public class DefaultTableColumnModel extends Object implements TableColumnModel, PropertyChangeListener, ListSelectionListener, Serializable

Стандартный обработчик столбцов для JTable.

Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или использования RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 поддержка длительного хранения всех JavaBeans добавлена в пакет java.beans. См. XMLEncoder.

См. также:

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

Модификатор и тип	Поле	Описание
`protected ChangeEvent`	`changeEvent`	Событие изменения (требуется только одно)
`protected int`	`columnMargin`	Отступ по ширине между столбцами
`protected boolean`	`columnSelectionAllowed`	Разрешено ли выделение столбцов в этой модели столбцов
`protected EventListenerList`	`listenerList`	Список TableColumnModelListener
`protected ListSelectionModel`	`selectionModel`	Модель для отслеживания выделения столбцов
`protected Vector<TableColumn>`	`tableColumns`	Массив объектов TableColumn в этой модели
`protected int`	`totalColumnWidth`	Локальный кэш суммарной ширины всех столбцов

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

Конструктор	Описание
`DefaultTableColumnModel()`	Создает модель столбцов таблицы по умолчанию.

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

Модификатор и тип	Метод	Описание
`void`	`addColumn(TableColumn aColumn)`	Добавляет `aColumn` в конец массива `tableColumns`.
`void`	`addColumnModelListener(TableColumnModelListener x)`	Добавляет слушателя событий модели столбцов таблицы.
`protected ListSelectionModel`	`createSelectionModel()`	Создает новую модель выделения списка по умолчанию.
`protected void`	`fireColumnAdded(TableColumnModelEvent e)`	Уведомляет всех слушателей, зарегистрированных для получения уведомлений о событиях этого типа.
`protected void`	`fireColumnMarginChanged()`	Уведомляет всех слушателей, зарегистрированных для получения уведомлений о событиях этого типа.
`protected void`	`fireColumnMoved(TableColumnModelEvent e)`	Уведомляет всех слушателей, зарегистрированных для получения уведомлений о событиях этого типа.
`protected void`	`fireColumnRemoved(TableColumnModelEvent e)`	Уведомляет всех слушателей, зарегистрированных для получения уведомлений о событиях этого типа.
`protected void`	`fireColumnSelectionChanged(ListSelectionEvent e)`	Уведомляет всех слушателей, зарегистрированных для получения уведомлений о событиях этого типа.
`TableColumn`	`getColumn(int columnIndex)`	Возвращает объект `TableColumn` для столбца с индексом `columnIndex`.
`int`	`getColumnCount()`	Возвращает количество столбцов в массиве `tableColumns`.
`int`	`getColumnIndex(Object identifier)`	Возвращает индекс первого столбца в массиве `tableColumns`, идентификатор которого равен `identifier` при сравнении с помощью `equals`.
`int`	`getColumnIndexAtX(int x)`	Возвращает индекс столбца, расположенного в позиции `x`, или -1, если ни один столбец не охватывает эту точку.
`int`	`getColumnMargin()`	Возвращает отступ по ширине для `TableColumn`.
`TableColumnModelListener[]`	`getColumnModelListeners()`	Возвращает массив всех слушателей модели столбцов, зарегистрированных в этой модели.
`Enumeration<TableColumn>`	`getColumns()`	Возвращает `Enumeration` всех столбцов модели.
`boolean`	`getColumnSelectionAllowed()`	Возвращает true, если выделение столбцов разрешено, иначе — false.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в этой модели в качестве `FooListener`.
`int`	`getSelectedColumnCount()`	Возвращает количество выделенных столбцов.
`int[]`	`getSelectedColumns()`	Возвращает массив выделенных столбцов.
`ListSelectionModel`	`getSelectionModel()`	Возвращает `ListSelectionModel`, используемую для поддержки состояния выделения столбцов.
`int`	`getTotalColumnWidth()`	Возвращает суммарную ширину всех столбцов.
`void`	`moveColumn(int columnIndex, int newIndex)`	Перемещает столбец и заголовок с позиции `columnIndex` на позицию `newIndex`.
`void`	`propertyChange(PropertyChangeEvent evt)`	Метод изменения слушателя изменений свойства.
`protected void`	`recalcWidthCache()`	Пересчитывает суммарную ширину всех столбцов.
`void`	`removeColumn(TableColumn column)`	Удаляет `column` из массива `tableColumns`.
`void`	`removeColumnModelListener(TableColumnModelListener x)`	Удаляет слушателя событий модели столбцов таблицы.
`void`	`setColumnMargin(int newMargin)`	Задает отступ столбца равным `newMargin`.
`void`	`setColumnSelectionAllowed(boolean flag)`	Задает, разрешено ли выделение столбцов.
`void`	`setSelectionModel(ListSelectionModel newModel)`	Задает модель выделения для этой `TableColumnModel` как `newModel` и регистрирует слушателя для получения уведомлений от новой модели выделения.
`void`	`valueChanged(ListSelectionEvent e)`	`ListSelectionListener`, который пересылает `ListSelectionEvents` при изменении выделения столбцов.

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

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

Подробное описание полей

tableColumns

protected Vector<TableColumn> tableColumns

Массив объектов TableColumn в этой модели

selectionModel

protected ListSelectionModel selectionModel

Модель для отслеживания выбранных столбцов

columnMargin

protected int columnMargin

Ширина отступа между каждым столбцом

listenerList

protected EventListenerList listenerList

Список объектов TableColumnModelListener

changeEvent

protected transient ChangeEvent changeEvent

Событие изменения (требуется только одно)

columnSelectionAllowed

protected boolean columnSelectionAllowed

Разрешено ли выделение столбцов в этой модели столбцов

totalColumnWidth

protected int totalColumnWidth

Локальный кэш суммарной ширины всех столбцов

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

DefaultTableColumnModel

public DefaultTableColumnModel()

Создает модель столбцов таблицы по умолчанию.

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

addColumn

public void addColumn(TableColumn aColumn)

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

Определен в:

addColumn в интерфейсе TableColumnModel

Параметры:

aColumn — TableColumn, который требуется добавить

Исключения:

IllegalArgumentException — если aColumn равен null

См. также:

removeColumn

public void removeColumn(TableColumn column)

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

Определен в:

removeColumn в интерфейсе TableColumnModel

Параметры:

column — TableColumn, который требуется удалить

См. также:

moveColumn

public void moveColumn(int columnIndex, int newIndex)

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

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

setColumnMargin

public void setColumnMargin(int newMargin)

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

Определен в:

setColumnMargin в интерфейсе TableColumnModel

Параметры:

newMargin — новая ширина отступа в пикселях

См. также:

getColumnCount

public int getColumnCount()

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

Определен в:

getColumnCount в интерфейсе TableColumnModel

Возвращает:

количество столбцов в массиве tableColumns

См. также:

getColumns

public Enumeration<TableColumn> getColumns()

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

Определен в:: getColumns в интерфейсе TableColumnModel
Возвращает:: Enumeration столбцов модели

getColumnIndex

public int getColumnIndex(Object identifier)

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

Определен в:

getColumnIndex в интерфейсе TableColumnModel

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

getColumn

public TableColumn getColumn(int columnIndex)

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

Определен в:: getColumn в интерфейсе TableColumnModel
Параметры:: columnIndex — индекс требуемого столбца
Возвращает:: объект TableColumn для столбца на позиции columnIndex
Исключения:: ArrayIndexOutOfBoundsException — если columnIndex находится вне допустимого диапазона: (columnIndex < 0 || columnIndex >= getColumnCount())

getColumnMargin

public int getColumnMargin()

Возвращает ширину отступа для TableColumn. Значение columnMargin по умолчанию равно 1.

Определен в:

getColumnMargin в интерфейсе TableColumnModel

Возвращает:

максимальную ширину для TableColumn

См. также:

getColumnIndexAtX

public int getColumnIndexAtX(int x)

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

Определен в:

getColumnIndexAtX в интерфейсе TableColumnModel

Параметры:

x — интересующая горизонтальная позиция

Возвращает:

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

См. также:

getTotalColumnWidth

public int getTotalColumnWidth()

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

Определен в:: getTotalColumnWidth в интерфейсе TableColumnModel
Возвращает:: свойство totalColumnWidth

setSelectionModel

public void setSelectionModel(ListSelectionModel newModel)

Устанавливает модель выбора для этой TableColumnModel равной newModel и регистрирует прослушивание уведомлений от новой модели выбора. Если newModel равен null, выбрасывается исключение.

Определен в:

setSelectionModel в интерфейсе TableColumnModel

Параметры:

newModel — новая модель выбора

Исключения:

IllegalArgumentException — если newModel равен null

См. также:

getSelectionModel

public ListSelectionModel getSelectionModel()

Возвращает ListSelectionModel, используемую для хранения состояния выбора столбцов.

Определен в:

getSelectionModel в интерфейсе TableColumnModel

Возвращает:

объект, предоставляющий состояние выбора столбцов. Или null, если выбор строк не разрешен.

См. также:

setColumnSelectionAllowed

public void setColumnSelectionAllowed(boolean flag)

Устанавливает, разрешен ли выбор столбцов. По умолчанию — false.

Определен в:

setColumnSelectionAllowed в интерфейсе TableColumnModel

Параметры:

flag — true, если выбор столбцов разрешен, иначе false

См. также:

getColumnSelectionAllowed

public boolean getColumnSelectionAllowed()

Возвращает true, если выбор столбцов разрешен, иначе false. По умолчанию — false.

Определен в:

getColumnSelectionAllowed в интерфейсе TableColumnModel

Возвращает:

свойство columnSelectionAllowed

См. также:

getSelectedColumns

public int[] getSelectedColumns()

Возвращает массив выбранных столбцов. Если selectionModel равен null, возвращается пустой массив.

Определен в:: getSelectedColumns в интерфейсе TableColumnModel
Возвращает:: массив выбранных столбцов или пустой массив, если ничего не выбрано или selectionModel равен null

getSelectedColumnCount

public int getSelectedColumnCount()

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

Определен в:: getSelectedColumnCount в интерфейсе TableColumnModel
Возвращает:: количество выбранных столбцов

addColumnModelListener

public void addColumnModelListener(TableColumnModelListener x)

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

Определен в:: addColumnModelListener в интерфейсе TableColumnModel
Параметры:: x — объект TableColumnModelListener

removeColumnModelListener

public void removeColumnModelListener(TableColumnModelListener x)

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

Определен в:: removeColumnModelListener в интерфейсе TableColumnModel
Параметры:: x — объект TableColumnModelListener

getColumnModelListeners

public TableColumnModelListener[] getColumnModelListeners()

Возвращает массив всех слушателей модели столбцов, зарегистрированных в этой модели.

Возвращает:

все ColumnModelListeners этой модели столбцов таблицы по умолчанию или пустой массив, если в данный момент не зарегистрировано ни одного слушателя модели столбцов

Начиная с:

1.4

См. также:

fireColumnAdded

protected void fireColumnAdded(TableColumnModelEvent e)

Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. Экземпляр события создается по мере необходимости с использованием параметров, переданных методу fire.

Параметры:

e — полученное событие

См. также:

fireColumnRemoved

protected void fireColumnRemoved(TableColumnModelEvent e)

Параметры:

e — полученное событие

См. также:

fireColumnMoved

protected void fireColumnMoved(TableColumnModelEvent e)

Параметры:

e — полученное событие

См. также:

fireColumnSelectionChanged

protected void fireColumnSelectionChanged(ListSelectionEvent e)

Параметры:

e — полученное событие

См. также:

fireColumnMarginChanged

protected void fireColumnMarginChanged()

См. также:

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, зарегистрированных в этой модели в качестве FooListeners. Регистрация FooListeners выполняется с помощью метода addFooListener.

В аргументе listenerType можно указать литерал класса, например FooListener.class. Например, можно запросить список слушателей модели столбцов у DefaultTableColumnModel m с помощью следующего кода:

ColumnModelListener[] cmls = (ColumnModelListener[])(m.getListeners(ColumnModelListener.class));

Если таких слушателей нет, этот метод возвращает пустой массив.

Параметры типа:

T — тип слушателя

Параметры:

listenerType — тип запрашиваемых слушателей

Возвращает:

массив всех объектов, зарегистрированных в этой модели в качестве FooListeners, или пустой массив, если такие слушатели не были добавлены

Исключения:

ClassCastException — если listenerType не задает класс или интерфейс, реализующий java.util.EventListener

Начиная с:

1.3

См. также:

propertyChange

public void propertyChange(PropertyChangeEvent evt)

Метод слушателя изменения свойства. Используется для отслеживания изменений ширины столбца или предпочтительной ширины столбца.

Определен в:: propertyChange в интерфейсе PropertyChangeListener
Параметры:: evt — PropertyChangeEvent

valueChanged

public void valueChanged(ListSelectionEvent e)

Объект ListSelectionListener, который передает ListSelectionEvents при изменении выбора столбцов.

Определен в:: valueChanged в интерфейсе ListSelectionListener
Параметры:: e — событие изменения

createSelectionModel

protected ListSelectionModel createSelectionModel()

Создает новую модель выбора списка по умолчанию.

Возвращает:: новую модель выбора списка по умолчанию.

recalcWidthCache

protected void recalcWidthCache()

Повторно вычисляет суммарную ширину всех столбцов. Обновляет свойство totalColumnWidth.

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