Класс TableModelEvent

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.

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

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 перерисует весь видимый регион при получении этого события, запросив у модели значения ячеек, которые видны. Структура таблицы (имена, типы и порядок столбцов) не изменилась.

TableModelEvent

public TableModelEvent(TableModel source,
                       int row)

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

TableModelEvent

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

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

TableModelEvent

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

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

TableModelEvent

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

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

getFirstRow

public int getFirstRow()

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

getLastRow

public int getLastRow()

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

getColumn

public int getColumn()

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

getType

public int getType()

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