Класс 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, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет java.beans. Обратитесь к 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`	Указывает изменение существующих данных.

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

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.

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

getSource, toString

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

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

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

См. также:

тип

protected int type

Тип события.

перваяСтрока

protected int firstRow

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

последняяСтрока

protected int lastRow

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

столбец

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)

Данные в строках [перваяСтрока, последняяСтрока] были обновлены.

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

TableModelEvent

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

Данные в столбце столбец в диапазоне [перваяСтрока, последняяСтрока] были обновлены.

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

TableModelEvent

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

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

Тип должен быть одним из: 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/event/TableModelEvent.html