JavaTM Platform
Standard Ed. 6

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
 
可以使用其他参数组合,但并不是所有的参数都有意义。通过创建子类,可以添加其他任何信息,例如:事件“将要”发生,还是“确实已经”发生。这使得 DELETE 事件中的行的指定更有用,但这并没有包含在 swing 包中,因为 JTable 只需要发送事件的通知。

警告:此类的序列化对象将与以后的 Swing 版本不兼容。当前的序列化支持适用于短期存储或运行相同 Swing 版本的应用程序之间的 RMI。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 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)
          列 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
指定一行或一些行中的所有列。

另请参见:
常量字段值

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 标志被设置,它将丢弃它所拥有的所有 TableColumn,并按照这些列在模型中出现的顺序重新分配默认列。此方法等效于在 JTable 上调用 setModel(TableModel)


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)
从 (firstRow, column) 到 (lastRow, column) 的单元格已被更改。 column 引用模型坐标系统中的单元格的列索引。当 column 为 ALL_COLUMNS 时,指定行范围中的所有单元格都被认为是已更改的。

type 应该是以下类型之一:INSERT、UPDATE 和 DELETE。

方法详细信息

getFirstRow

public int getFirstRow()
返回第一个被更改的行。HEADER_ROW 表示元数据,即列的名称、类型和顺序。


getLastRow

public int getLastRow()
返回最后一个被更改的行。


getColumn

public int getColumn()
返回事件的列。如果返回值为 ALL_COLUMNS,则意味着指定行中的所有列都被更改。


getType

public int getType()
返回事件类型,该类型为以下类型之一:INSERT、UPDATE 和 DELETE。


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策