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

Возможны и другие комбинации параметров, не все из них имеют смысл. Подклассы могут добавлять другую информацию, например: произойдёт ли событие или уже произошло. Это делает указание строк в событиях удаления более полезным, но не включено в пакет 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 установлен, он отбрасывает все setModel(TableModel) и перераспределяет стандартные в порядке их появления в модели. Это то же самое, что вызов 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, 2023, 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/21/docs/api/java.desktop/javax/swing/event/TableModelEvent.html