モジュール java.desktop

パッケージ javax.swing.event

クラス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
 

ほかのパラメータの組み合わせを使用することもできますが、すべてが有用であるとは限りません。 サブクラス化することにより、たとえば、イベントWILLが発生したか、イベントDIDが発生したかなど、ほかの情報を追加することもできます。 これにより、DELETEイベントでの行の指定がしやすくなりますが、JTableではイベント後の通知だけが必要なので、Swingパッケージには含まれていません。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 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)	[firstRow, lastRow]の範囲の列column内のセルが更新されています。
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

ある行または複数の行のすべての列を指定します。

関連項目:

• 定数フィールド値

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)

このデータの行は更新されています。 構造が異なる完全に新しいテーブルの出現を示すには、rowの値としてHEADER_ROWを使用します。 JTableは、このイベントを受け取り、autoCreateColumnsFromModelフラグがセットされると、TableColumnがあればすべて破棄し、モデルで表示される順番でデフォルトの列を割り当てし直します。 これは、JTableでsetModel(TableModel)を呼び出すのと同じです。

パラメータ:

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)

[firstRow, lastRow]の範囲の列column内のセルが更新されています。

パラメータ:

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が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 ofrow(s) orcolumn(s)またはUPDATE