Java javax.swing 类 JTable（JDK5）

所有类

javax.swing
类 JTable

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JTable

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, EventListener, Accessible, CellEditorListener, ListSelectionListener, TableColumnModelListener, TableModelListener, Scrollable

public class JTable
   
   
   
   
extends JComponent
   
   
   
   
   
   
   
   
implements TableModelListener, Scrollable, TableColumnModelListener, ListSelectionListener, CellEditorListener, Accessible
   
   
   
   

JTable 用来显示和编辑规则的二维单元表。有关面向任务的文档和使用 JTable 的示例，请参阅《The Java Tutorial》中的 How to Use Tables 一节。

JTable 有很多用来自定义其呈现和编辑的设施，同时提供了这些功能的默认设置，从而可轻松地设置简单表。例如，要设置一个 10 行 10 列的表：

      TableModel dataModel = new AbstractTableModel() {
          public int getColumnCount() { return 10; }
          public int getRowCount() { return 10;}
          public Object getValueAt(int row, int col) { return new Integer(row*col); }
      };
      JTable table = new JTable(dataModel);
      JScrollPane scrollpane = new JScrollPane(table);
 

注意，如果要在单独的视图中（在 JScrollPane 外）使用 JTable 并显示表标题，则可以使用 getTableHeader() 获取并单独显示它。

设计使用 JTable 的应用程序时，要严格注意用来表示表数据的数据结构。DefaultTableModel 是一个模型实现，它使用一个 Vector 来存储所有单元格的值。该 Vector 由包含多个 Object 的 Vector 组成。除了将数据从应用程序复制到 DefaultTableModel 中之外，还可以 TableModel 接口的方法来包装数据，这样可将数据直接传递到 JTable，如以上示例所示。这通常可以提高应用程序的效率，因为模型可以自由选择最适合数据的内部表示形式。在决定使用 AbstractTableModel 还是使用 DefaultTableModel 方面有一个好的实践经验，即在创建子类时使用 AbstractTableModel 作为基类，在不需要创建子类时则使用 DefaultTableModel。

在发行的源代码演示部分中的 "TableExample" 目录内给出了许多 JTable 用法的完整示例，包括如何使用 JTable 来提供一个可编辑的数据视图（数据来自数据库），以及如何修改正显示的列以使用特殊的渲染器和编辑器。

JTable 使用惟一的整数来引用它所显示的模型的行和列。JTable 只是采用表格的单元格范围，并在绘制时使用 getValueAt(int, int) 从模型中检索值。

默认情况下，在 JTable 中对列进行重新安排，这样在视图中列的出现顺序与模型中列的顺序不同。但这根本不影响模型的实现：当列重新排列时，JTable 在内部保持列的新顺序，并在查询模型前转换其列的索引。

因此编写 TableModel 时，不必侦听列的重排事件，因为将在模型自己的坐标系统中查询它，而不管视图中发生了什么情况。在示例部分中有一个排序算法的演示，此演示正是使用了此技术在另一个坐标系统中进行排序，其中更改行的顺序，而不更改列的顺序。

J2SE 5 在 JTable 中添加了一些方法，从而为某些普通打印需求提供方便的访问。print() 是一个简单的新方法，它允许快速简单地向应用程序添加打印支持。另外，新的 getPrintable(javax.swing.JTable.PrintMode, java.text.MessageFormat, java.text.MessageFormat) 方法可满足更高级的打印需求。

对于所有的 JComponent 类，可以使用 InputMap 和 ActionMap 将 Action 对象与 KeyStroke 进行关联，并在指定的条件下执行操作。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

AUTO_RESIZE_OFF

public static final int AUTO_RESIZE_OFF

不自动调整列的宽度；使用滚动条。

另请参见：

常量字段值

AUTO_RESIZE_NEXT_COLUMN

public static final int AUTO_RESIZE_NEXT_COLUMN

在 UI 中调整列时，对其下一列进行相反方向的调整。

另请参见：

常量字段值

AUTO_RESIZE_SUBSEQUENT_COLUMNS

public static final int AUTO_RESIZE_SUBSEQUENT_COLUMNS

在 UI 调整中，更改后续列以保持总宽度不变，这是默认的行为。

另请参见：

常量字段值

AUTO_RESIZE_LAST_COLUMN

public static final int AUTO_RESIZE_LAST_COLUMN

在所有的调整大小操作中，只对最后一列进行调整。

另请参见：

常量字段值

AUTO_RESIZE_ALL_COLUMNS

public static final int AUTO_RESIZE_ALL_COLUMNS

在所有的调整大小操作中，按比例调整所有的列。

另请参见：

常量字段值

dataModel

protected TableModel dataModel

表的 TableModel。

columnModel

protected TableColumnModel columnModel

表的 TableColumnModel。