Класс DefaultTableColumnModel

java.lang.Object

javax.swing.table.DefaultTableColumnModel

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

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

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

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями 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()`	Возвращает массив всех столбцов в модели.
`boolean`	`getColumnSelectionAllowed()`	Возвращает true, если разрешен выбор столбцов, иначе false.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных как `FooListener` в этой модели.
`int`	`getSelectedColumnCount()`	Возвращает количество выбранных столбцов.
`int[]`	`getSelectedColumns()`	Возвращает массив выбранных столбцов.
`ListSelectionModel`	`getSelectionModel()`	Возвращает модель выбора, используемую для сохранения состояния выбора столбцов.
`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` при изменении выбора столбцов.

Методы, объявленные в классе java.lang.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 для своих слушателей.

Specified by:

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

Parameters:

aColumn - добавляемый TableColumn

Throws:

IllegalArgumentException - если aColumn является null

See Also:

removeColumn

public void removeColumn(TableColumn column)

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

Specified by:

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

Parameters:

column - удаляемый TableColumn

See Also:

moveColumn

public void moveColumn(int columnIndex, int newIndex)

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

Specified by:: moveColumn в интерфейсе TableColumnModel
Parameters:: columnIndex - индекс перемещаемого столбца; newIndex - новый индекс столбца
Throws:: IllegalArgumentException - если column или newIndex находятся вне допустимого диапазона

setColumnMargin

public void setColumnMargin(int newMargin)

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

Specified by:

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

Parameters:

newMargin - новая ширина полей в пикселях

See Also:

getColumnCount

public int getColumnCount()

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

Specified by:

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

Returns:

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

See Also:

getColumns

public Enumeration<TableColumn> getColumns()

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

Specified by:: getColumns в интерфейсе TableColumnModel
Returns:: список столбцов в модели

getColumnIndex

public int getColumnIndex(Object identifier)

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

Specified by:

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

Parameters:

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

Returns:

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

Throws:

IllegalArgumentException - если identifier является null, или если столбец с данным TableColumn не найден

See Also:

getColumn

public TableColumn getColumn(int columnIndex)

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

Specified by:: getColumn в интерфейсе TableColumnModel
Parameters:: columnIndex - индекс нужного столбца
Returns:: объект TableColumn для столбца по индексу columnIndex
Throws:: ArrayIndexOutOfBoundsException - если columnIndex находится за пределами диапазона: (columnIndex < 0 || columnIndex >= getColumnCount())

getColumnMargin

public int getColumnMargin()

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

Specified by:

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

Returns:

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

See Also:

getColumnIndexAtX

public int getColumnIndexAtX(int x)

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

Specified by:

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

Parameters:

x - горизонтальное положение

Returns:

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

See Also:

getTotalColumnWidth

public int getTotalColumnWidth()

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

Specified by:: getTotalColumnWidth в интерфейсе TableColumnModel
Returns:: свойство totalColumnWidth

setSelectionModel

public void setSelectionModel(ListSelectionModel newModel)

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

Specified by:

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

Parameters:

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

Throws:

IllegalArgumentException - если newModel равно null

See Also:

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()

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

Возвращает:

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

Since:

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)

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

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

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

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

Type Parameters:

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

Параметры:

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

Возвращает:

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

Исключение:

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

Since:

1.3

См. также:

propertyChange

public void propertyChange(PropertyChangeEvent evt)

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

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

valueChanged

public void valueChanged(ListSelectionEvent e)

Метод, который пересылает уведомления о событиях выбора столбцов.

Определено в:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/table/DefaultTableColumnModel.html