Класс TableModelEvent

java.lang.Object

java.util.EventObject

javax.swing.event.TableModelEvent

Все реализованные интерфейсы:: Serializable

public class TableModelEvent extends EventObject

TableModelEvent используется для уведомления слушателей об изменении модели таблицы. Событие модели описывает изменения в TableModel, при этом все ссылки на строки и столбцы задаются в системе координат модели. В зависимости от параметров, переданных конструкторам, TableModelevent может использоваться для указания следующих типов изменений:

TableModelEvent(source);              //  The data, ie. all rows changed
TableModelEvent(source, HEADER_ROW);  //  Structure change, reallocate TableColumns
TableModelEvent(source, 1);           //  Row 1 changed
TableModelEvent(source, 3, 6);        //  Rows 3 to 6 inclusive changed
TableModelEvent(source, 2, 2, 6);     //  Cell at (2, 6) changed
TableModelEvent(source, 3, 6, ALL_COLUMNS, INSERT); // Rows (3, 6) were inserted
TableModelEvent(source, 3, 6, ALL_COLUMNS, DELETE); // Rows (3, 6) were deleted

Можно использовать и другие сочетания параметров, но не все из них имеют смысл. Переопределив класс, можно добавить дополнительную информацию, например: произойдет событие или уже произошло. Это делает указание строк в событиях DELETE более полезным, но не включено в пакет swing, поскольку JTable требуется только уведомление о событии после его возникновения.

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

См. также:

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

Модификатор и тип	Поле	Описание
`static final int`	`ALL_COLUMNS`	Указывает все столбцы в одной или нескольких строках.
`protected int`	`column`	Столбец, к которому относится событие.
`static final int`	`DELETE`	Указывает на удаление строк или столбцов.
`protected int`	`firstRow`	Первая измененная строка.
`static final int`	`HEADER_ROW`	Указывает на строку заголовка.
`static final int`	`INSERT`	Указывает на добавление новых строк или столбцов.
`protected int`	`lastRow`	Последняя измененная строка.
`protected int`	`type`	Тип события.
`static final int`	`UPDATE`	Указывает на изменение существующих данных.

Поля, объявленные в классе EventObject

source

Модификатор и тип	Поле	Описание
`protected Object`	`source`	Объект, в котором первоначально произошло событие.

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

Конструктор	Описание
`TableModelEvent(TableModel source)`	Все данные строк таблицы изменились; слушателям следует отбросить любое состояние, основанное на строках, и заново запросить `TableModel`, чтобы получить новое количество строк и все соответствующие значения.
`TableModelEvent(TableModel source, int row)`	Данные этой строки обновлены.
`TableModelEvent(TableModel source, int firstRow, int lastRow)`	Данные в строках [firstRow, lastRow] обновлены.
`TableModelEvent(TableModel source, int firstRow, int lastRow, int column)`	Ячейки столбца column в диапазоне [firstRow, lastRow] обновлены.
`TableModelEvent(TableModel source, int firstRow, int lastRow, int column, int type)`	Ячейки от (firstRow, column) до (lastRow, column) изменены.

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

Модификатор и тип	Метод	Описание
`int`	`getColumn()`	Возвращает столбец, к которому относится событие.
`int`	`getFirstRow()`	Возвращает первую измененную строку.
`int`	`getLastRow()`	Возвращает последнюю измененную строку.
`int`	`getType()`	Возвращает тип события: INSERT, UPDATE или DELETE.

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

getSource, toString

Модификатор и тип	Метод	Описание
`Object`	`getSource()`	Объект, в котором первоначально произошло событие.
`String`	`toString()`	Возвращает строковое представление этого EventObject.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в ожидание до пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в ожидание до пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в ожидание до пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного времени.

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

INSERT

public static final int INSERT

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

См. также:

UPDATE

public static final int UPDATE

Указывает на изменение существующих данных.

См. также:

DELETE

public static final int DELETE

Указывает на удаление строк или столбцов.

См. также:

HEADER_ROW

public static final int HEADER_ROW

Указывает на строку заголовка.

См. также:

ALL_COLUMNS

public static final int ALL_COLUMNS

Указывает все столбцы в одной или нескольких строках.

См. также:

type

protected int type

Тип события.

firstRow

protected int firstRow

Первая измененная строка.

lastRow

protected int lastRow

Последняя измененная строка.

column

protected int column

Столбец, к которому относится событие.

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

TableModelEvent

public TableModelEvent(TableModel source)

Все данные строк таблицы изменились; слушателям следует отбросить любое состояние, основанное на строках, и заново запросить TableModel, чтобы получить новое количество строк и все соответствующие значения. При получении этого события JTable перерисует всю видимую область, запросив у модели значения видимых ячеек. Структура таблицы, то есть имена, типы и порядок столбцов, не изменилась.

Параметры:: source — TableModel, затронутая этим событием

TableModelEvent

public TableModelEvent(TableModel source, int row)

Данные этой строки обновлены. Чтобы обозначить появление совершенно новой таблицы с другой структурой, используйте HEADER_ROW в качестве значения для row. Когда JTable получает это событие и установлен его флаг autoCreateColumnsFromModel, он удаляет все имевшиеся у него TableColumns и создает новые, используемые по умолчанию, в порядке их расположения в модели. Это эквивалентно вызову setModel(TableModel) для JTable.

Параметры:: source — TableModel, затронутая этим событием; row — обновленная строка

TableModelEvent

public TableModelEvent(TableModel source, int firstRow, int lastRow)

Данные в строках [firstRow, lastRow] обновлены.

Параметры:: source — TableModel, затронутая этим событием; firstRow — первая строка, затронутая этим событием; lastRow — последняя строка, затронутая этим событием

TableModelEvent

public TableModelEvent(TableModel source, int firstRow, int lastRow, int column)

Ячейки столбца column в диапазоне [firstRow, lastRow] обновлены.

Параметры:: source — TableModel, затронутая этим событием; firstRow — первая строка, затронутая этим событием; lastRow — последняя строка, затронутая этим событием; column — индекс столбца измененных ячеек; ALL_COLUMNS означает, что изменены все ячейки в указанном диапазоне строк.

TableModelEvent

public TableModelEvent(TableModel source, int firstRow, int lastRow, int column, int type)

Ячейки от (firstRow, column) до (lastRow, column) изменены. column обозначает индекс столбца ячейки в системе координат модели. Если column равен ALL_COLUMNS, считаются измененными все ячейки в указанном диапазоне строк.

type должен иметь одно из следующих значений: INSERT, UPDATE или DELETE.

Параметры:: source — TableModel, затронутая этим событием; firstRow — первая строка, затронутая этим событием; lastRow — последняя строка, затронутая этим событием; column — индекс столбца измененных ячеек; ALL_COLUMNS означает, что изменены все ячейки в указанном диапазоне строк.; type — тип изменения, обозначаемый этим событием: INSERT, DELETE или UPDATE

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

getFirstRow

public int getFirstRow()

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

Возвращает:: целое число, обозначающее первую измененную строку

getLastRow

public int getLastRow()

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

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

getColumn

public int getColumn()

Возвращает столбец, к которому относится событие. Если возвращаемое значение — ALL_COLUMNS, это означает, что изменились все столбцы в указанных строках.

Возвращает:: целое число, обозначающее столбец, затронутый этим событием

getType

public int getType()

Возвращает тип события: INSERT, UPDATE или DELETE.

Возвращает:: тип изменения модели таблицы: INSERT или DELETE строк или столбцов либо UPDATE данных

© 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.