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

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

Конструктор	Описание
`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

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

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

См. также:

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/event/TableModelEvent.html