モジュール 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 int ALL_COLUMNS
    ある行または複数の行のすべての列を指定します。
    protected int column
    イベントの列。
    static int DELETE
    行または列の削除を識別します。
    protected int firstRow
    変更された最初の行。
    static int HEADER_ROW
    ヘッダー行を識別します。
    static int INSERT
    新しい行または列の追加を識別します。
    protected int lastRow
    変更された最後の行。
    protected int type
    イベントの型。
    static 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

  • フィールド詳細

  • コンストラクタの詳細

    • 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は、モデルの座標体系でのセルの列インデックスを参照します。 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のどれかです。
      戻り値:
      表モデルへの変更の型、行またはcolumn(s)またはUPDATEのデータへのINSERTまたはDELETE