Класс 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.

См. также:

JTable

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

Модификатор и тип	Поле	Описание
`protected ChangeEvent`	`changeEvent`	Изменение события (только одно необходимо)
`protected int`	`columnMargin`	Поля отступа между столбцами
`protected boolean`	`columnSelectionAllowed`	Разрешение выбора столбцов в этой модели столбцов
`protected EventListenerList`	`listenerList`	Список слушателей событий TableColumnModel
`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)`	Слушатель, который пересылает `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(javax.swing.table.TableColumn)

removeColumn

public void removeColumn(TableColumn column)

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

Specified by:

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

Parameters:

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

See Also:

addColumn(javax.swing.table.TableColumn)

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:

getColumnMargin()
getTotalColumnWidth()

getColumnCount

public int getColumnCount()

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

Specified by:

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

Returns:

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

See Also:

getColumns()

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

getColumn

public TableColumn getColumn(int columnIndex)

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

Specified by:: getColumn в интерфейсе TableColumnModel
Parameters:: columnIndex - индекс желаемого столбца
Returns:: объект TableColumn для столбца в позиции columnIndex

getColumnMargin

public int getColumnMargin()

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

Specified by:

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

Returns:

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

See Also:

setColumnMargin(int)

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:

JTable.columnAtPoint(java.awt.Point)

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

getSelectionModel

public ListSelectionModel getSelectionModel()

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

Specified by:

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

Returns:

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

See Also:

setSelectionModel(javax.swing.ListSelectionModel)

setColumnSelectionAllowed

public void setColumnSelectionAllowed(boolean flag)

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

Specified by:

setColumnSelectionAllowed in interface TableColumnModel

Parameters:

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

See Also:

TableColumnModel.getColumnSelectionAllowed()

getColumnSelectionAllowed

public boolean getColumnSelectionAllowed()

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

Specified by:

getColumnSelectionAllowed in interface TableColumnModel

Returns:

свойство columnSelectionAllowed

See Also:

TableColumnModel.setColumnSelectionAllowed(boolean)

getSelectedColumns

public int[] getSelectedColumns()

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

Specified by:: getSelectedColumns in interface TableColumnModel
Returns:: массив выделенных столбцов или пустой массив, если ничего не выделено или selectionModel — null

getSelectedColumnCount

public int getSelectedColumnCount()

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

Specified by:: getSelectedColumnCount in interface TableColumnModel
Returns:: количество выделенных столбцов

addColumnModelListener

public void addColumnModelListener(TableColumnModelListener x)

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

Specified by:: addColumnModelListener in interface TableColumnModel
Parameters:: x - объект TableColumnModelListener

removeColumnModelListener

public void removeColumnModelListener(TableColumnModelListener x)

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

Specified by:: removeColumnModelListener in interface TableColumnModel
Parameters:: x - объект TableColumnModelListener

getColumnModelListeners

public TableColumnModelListener[] getColumnModelListeners()

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

Returns:

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

Since:

1.4

See Also:

addColumnModelListener(javax.swing.event.TableColumnModelListener)
removeColumnModelListener(javax.swing.event.TableColumnModelListener)

fireColumnAdded

protected void fireColumnAdded(TableColumnModelEvent e)

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

Parameters:

e - событие

See Also:

EventListenerList

fireColumnRemoved

protected void fireColumnRemoved(TableColumnModelEvent e)

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

Parameters:

e - событие

See Also:

EventListenerList

fireColumnMoved

protected void fireColumnMoved(TableColumnModelEvent e)

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

Parameters:

e - событие

See Also:

EventListenerList

fireColumnSelectionChanged

protected void fireColumnSelectionChanged(ListSelectionEvent e)

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

Parameters:

e - событие

See Also:

EventListenerList

fireColumnMarginChanged

protected void fireColumnMarginChanged()

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

See Also:

EventListenerList

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 - тип слушателя

Parameters:

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

Returns:

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

Throws:

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

Since:

1.3

See Also:

getColumnModelListeners()

propertyChange

public void propertyChange(PropertyChangeEvent evt)

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

Specified by:: propertyChange in interface PropertyChangeListener
Parameters:: evt - событие изменения свойства PropertyChangeEvent

valueChanged

public void valueChanged(ListSelectionEvent e)

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

Specified by:: valueChanged in interface ListSelectionListener
Parameters:: e - событие изменения

createSelectionModel

protected ListSelectionModel createSelectionModel()

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

Returns:: новая созданная модель выбора по умолчанию.

recalcWidthCache

protected void recalcWidthCache()

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

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/table/DefaultTableColumnModel.html