Класс DefaultTableColumnModel

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

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

Поля

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. Значение по умолчанию columnMargin равно 1.

Specified by:

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

Returns:

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

See Also:

setColumnMargin(int)

getColumnIndexAtX

public int getColumnIndexAtX(int x)

Возвращает индекс столбца, который находится в позиции x, или -1, если ни один столбец не охватывает эту точку. В соответствии с архитектурой Swing's separable model, 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 в интерфейсе TableColumnModel

Parameters:

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

See Also:

TableColumnModel.getColumnSelectionAllowed()

getColumnSelectionAllowed

public boolean getColumnSelectionAllowed()

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

Specified by:

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

Returns:

свойство columnSelectionAllowed

See Also:

TableColumnModel.setColumnSelectionAllowed(boolean)

getSelectedColumns

public int[] getSelectedColumns()

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

Specified by:

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

Returns:

массив выбранных столбцов или пустой массив, если ничего не выделено или selectionModel является null

getSelectedColumnCount

public int getSelectedColumnCount()

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

Specified by:

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

Returns:

количество выделенных столбцов

addColumnModelListener

public void addColumnModelListener(TableColumnModelListener x)

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

Указано в:

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

Параметры:

x - объект TableColumnModelListener

removeColumnModelListener

public void removeColumnModelListener(TableColumnModelListener x)

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

Указано в:

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

Параметры:

x - объект TableColumnModelListener

getColumnModelListeners

public TableColumnModelListener[] getColumnModelListeners()

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

Возвращает:

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

С:

1.4

См. также:

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

fireColumnAdded

protected void fireColumnAdded(TableColumnModelEvent e)

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

Параметры:

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

См. также:

EventListenerList

fireColumnRemoved

protected void fireColumnRemoved(TableColumnModelEvent e)

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

Параметры:

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

См. также:

EventListenerList

fireColumnMoved

protected void fireColumnMoved(TableColumnModelEvent e)

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

Параметры:

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

См. также:

EventListenerList

fireColumnSelectionChanged

protected void fireColumnSelectionChanged(ListSelectionEvent e)

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

Параметры:

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

См. также:

EventListenerList

fireColumnMarginChanged

protected void fireColumnMarginChanged()

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

См. также:

EventListenerList

getListeners

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

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

Параметры:

listenerType - тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, который наследуется от java.util.EventListener

Возвращает:

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

Исключения:

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

С:

1.3

См. также:

getColumnModelListeners()

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.