站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

TableModel (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

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)
          返回 columnIndexrowIndex 位置的单元格值。
 boolean isCellEditable(int rowIndex, int columnIndex)
          如果 rowIndexcolumnIndex 位置的单元格是可编辑的,则返回 true。
 void removeTableModelListener(TableModelListener l)
          每当数据模型发生更改时,就从被通知的列表中移除一个侦听器。
 void setValueAt(Object aValue, int rowIndex, int columnIndex)
          将 columnIndexrowIndex 位置的单元格中的值设置为 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)
如果 rowIndexcolumnIndex 位置的单元格是可编辑的,则返回 true。否则,在该单元格上调用 setValueAt 不会更改该单元格的值。

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

getValueAt

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

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

setValueAt

void setValueAt(Object aValue,
                int rowIndex,
                int columnIndex)
columnIndexrowIndex 位置的单元格中的值设置为 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 2 Platform
Standard Ed. 5.0

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

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