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

См. также:

TableModel

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

Модификатор и тип	Поле	Описание
`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

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

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

public int getFirstRow()

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

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

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

public int getLastRow()

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

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

столбец

public int getColumn()

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

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

тип

public int getType()

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

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

© 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/event/TableModelEvent.html