Класс 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, в пакет java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. 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)`	Метод обработки изменения Property Change Listener.
`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

Модификатор и тип	Метод	Описание
`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()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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

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

Возвращает:

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

Начиная с версии:

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)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Выбрасывает:

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.