JavaTM Platform
Standard Ed. 6

javax.swing.table
接口 TableModel

所有已知实现类:
AbstractTableModel, DefaultTableModel

public interface TableModel

TableModel 接口指定了 JTable 用于询问表格式数据模型的方法。

只要数据模型实现了 TableModel 接口,就可以通过以下两行代码设置 JTable 显示该模型:

        TableModel myData = new MyTableModel(); 
        JTable table = new JTable(myData);
  

有关进一步的文档,请参见 The Java Tutorial 中的 Creating a Table Model 一节。

另请参见:
JTable

方法摘要
 void addTableModelListener(TableModelListener l)
          每当数据模型发生更改时,就将一个侦听器添加到被通知的列表中。
 Class<?> getColumnClass(int columnIndex)
          针对列中所有的单元格值,返回最具体的超类。
 int getColumnCount()
          返回该模型中的列数。
 String getColumnName(int columnIndex)
          返回 columnIndex 位置的列的名称。
 int getRowCount()
          返回该模型中的行数。
 Object getValueAt(int rowIndex, int columnIndex)
          返回 columnIndex 和 rowIndex 位置的单元格值。
 boolean isCellEditable(int rowIndex, int columnIndex)
          如果 rowIndex 和 columnIndex 位置的单元格是可编辑的,则返回 true。
 void removeTableModelListener(TableModelListener l)
          每当数据模型发生更改时,就从被通知的列表中移除一个侦听器。
 void setValueAt(Object aValue, int rowIndex, int columnIndex)
          将 columnIndex 和 rowIndex 位置的单元格中的值设置为 aValue。
 

方法详细信息

getRowCount

int getRowCount()
返回该模型中的行数。JTable 使用此方法来确定它应该显示多少行。此方法应该是快速执行的,因为在呈现期间会经常调用它。

返回:
该模型中的行数
另请参见:
getColumnCount()

getColumnCount

int getColumnCount()
返回该模型中的列数。JTable 使用此方法来确定在默认情况下它应该创建并显示多少列。

返回:
该模型中的列数
另请参见:
getRowCount()

getColumnName

String getColumnName(int columnIndex)
返回 columnIndex 位置的列的名称。这用于初始化该表的列头名。注:此名称不必是惟一的;表中的两列可以具有相同的名称。

参数:
columnIndex - 列的索引
返回:
列的名称

getColumnClass

Class<?> getColumnClass(int columnIndex)
针对列中所有的单元格值,返回最具体的超类。JTable 使用此方法来设置列的默认渲染器和编辑器。

参数:
columnIndex - 列的索引
返回:
模型中对象值的公共祖先类。

isCellEditable

boolean isCellEditable(int rowIndex,
                       int columnIndex)
如果 rowIndex 和 columnIndex 位置的单元格是可编辑的,则返回 true。否则,在该单元格上调用 setValueAt 不会更改该单元格的值。

参数:
rowIndex - 要查询的值所在行
columnIndex - 要查询的值所在列
返回:
如果该单元格是可编辑的,则返回 true
另请参见:
setValueAt(java.lang.Object, int, int)

getValueAt

Object getValueAt(int rowIndex,
                  int columnIndex)
返回 columnIndex 和 rowIndex 位置的单元格值。

参数:
rowIndex - 要查询的值所在行
columnIndex - 要查询的值所在列
返回:
指定单元格位置的值 Object

setValueAt

void setValueAt(Object aValue,
                int rowIndex,
                int columnIndex)
将 columnIndex 和 rowIndex 位置的单元格中的值设置为 aValue。

参数:
aValue - 新值
rowIndex - 要更改的值所在行
columnIndex - 要更改的值所在列
另请参见:
getValueAt(int, int), isCellEditable(int, int)

addTableModelListener

void addTableModelListener(TableModelListener l)
每当数据模型发生更改时,就将一个侦听器添加到被通知的列表中。

参数:
l - TableModelListener

removeTableModelListener

void removeTableModelListener(TableModelListener l)
每当数据模型发生更改时,就从被通知的列表中移除一个侦听器。

参数:
l - TableModelListener

JavaTM Platform
Standard Ed. 6

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

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