Swing颇受欢迎的JTable类为显示大块数据提供了一种简单的机制。JTable有很多东西是用于数据的生成和编辑,其中的很多东西还可以自定义,从而更进一步增强其功能。本文会引导你一步步地进入JTable的世界。

Listing A包含了一个简单示例的代码,这个示例会说明常用JTable的行为。用户能够更改JTable的布局、拖放它的栏,或者通过拖动标题的分隔线来改变其大小。

这些列被保存在一个String数组里:
String[] columnNames = {"Product","Number of Boxes","Price"};

数据被初始化并保存在一个二维的对象数组里:
Object[][] data =
{
{"Apples", new Integer(5),"5.00"},
         {"Oranges", new Integer(3),"6.00"},
         {"Pears", new Integer(2),"4.00"},
         {"Grapes", new Integer(3),"2.00"},
};


JTable是使用datacolumnNames构成的:
JTable table = new JTable(data, columnNames);

查看JTable

JTable的高度和宽度按照下面的方法来设定:
table.setPreferredScrollableViewportSize(new Dimension(300, 80));

如果JTable的一个列或者JTable窗口自身的大小被重新确定,那么其他列会被相应的缩小或者放大,以适应新的窗口。使用setAutoResizeMode()方法就能够控制这种行为:
table.setAutoResizeMode(int mode);

mode整数字段可能的值有:
AUTO_RESIZE_OFF
AUTO_RESIZE_NEXT_COLUMN
AUTO_RESIZE_SUBSEQUENT_COLUMNS
AUTO_RESIZE_LAST_COLUMN
AUTO_RESIZE_ALL_COLUMNS

表格的缺省值

单元格内方格坐标线的缺省颜色是Color.gray。要更改这些方格坐标线的颜色,就要用到:
table.setGridColor(Color.black);

你可以用下面的方法来改变行的高度:
table.setRowHeight(intpixelHeight);

各个单元格的高度将等于行的高度减去行间的距离。

在缺省情况下,内容的前景颜色和背景颜色的选择都是由Swing的所见即所得的实现来确定的。你可以使用下面的方法来更改选择的颜色:
table.setSelectionBackground(Color.black); table.setSelectionForeground(Color.white);

你也可以隐藏单元格的方格坐标线,就像下面这样:
table.setShowHorizontalLines(false);
table.setShowVerticalLines(false);


A显示了一个隐藏了其水平坐标线的JTable。

图A



列的宽度

JTable组件有几个控制表格特性的类和接口。TableColumn会不断追踪列的宽度,并负责列大小的调整,包括最大和最小宽度。

TableColumnModel管理着TableColumns的集合以及列的选择。要设置某个列的宽度,就要为表格列的模型设置一个参照。然后,取得想要的TableColumn并调用其setPreferredWidth()方法:
TableColumncolumn = table.getColumnModel().getColumn(0);
column.setPreferredWidth(100);


当用户拖放列的时候,列的索引并不会发生改变。getColumn(0)方法会一直返回正确的列,无论它出现在屏幕的哪个地方。

标题

JtableHeader会处理JTable标题的显示。你可以细分JtableHeader以获得自定义的布局。例如,如果你的应用程序需要一个跨越多个列的标题,那么只用简单地细分JtableHeader并将它集成到你的JTable里就行了。

你可以通过为当前JTable的JtableHeader设置一个参照或者调用其setReorderingAllowed()方法,来指定标题的重新排序是否被允许:
table.getTableHeader().setReorderingAllowed(false);

类似地,你可以确信列不会因为在列标题之间拖动而改变大小。要达到这个目的,你就要使用setResizingAllowed()方法:
table.getTableHeader().setResizingAllowed(false);

选择模式

在缺省状况下,当用户在JTable里选择一个单元格的时候,整个行都被选中了。有多种方法能够让用户自定义选择的方式。利用ListSelectionModel接口,你可以允许用户选择单个或者多个行:
table.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);

ListSelectionModel有下面这些字段:

  • SINGLE_SELECTION允许一次选择一行。
  • SINGLE_INTERVAL_SELECTION允许选择相邻的一系列行。
  • MULTIPLE_INTERVAL_SELECTION也允许选择相邻的列,但是带有扩展功能。它允许用户使用[Ctrl]键进行多个互不相邻的选择(即选择不相邻的行)。

setCellSelectionEnabled()方法让用户能够同时选择单个单元格或者整个行:
table.setCellSelectionEnabled(true);

如果被设置为是,setCellSelectionEnabled()方法还会允许在选择行和单个单元格的同时选择列,如果B所示。

图B

编辑单元格

我们这个简单的表格允许用户编辑表格里的任何单元格。Listing B列出了一个表格,它允许由程序员来决定哪些单元格能够被编辑。第一步是创建一个自定义的TableModel:
class SimpleTableModel extends AbstractTableModel {}

数据被封装在TableModel里,当JTable初始化的时候,自定义的TableModel就被作为一个参数传递给JTable的构造函数而不是那个二维的对象数组:
  SimpleTableModelmyModel = new SimpleTableModel();
  JTable table = new JTable(myModel);


如果想让第二列和第三列也变得可以编辑,并把第一列变成恒定的,那么你就要强制替代TableModel的isCellEditable()方法:
public booleanisCellEditable(int row, intcol){
if (col == 0) {return false;}
         else          {return true; }
}


简单的表格验证

你需要确保用户只输入整数值,假如说,向第二列(“盒子的数量”这一列)输入值来强制替代setValueAt()方法,并将验证逻辑包括进这个新方法里。首先,你要检查列是否是整数,以及这个列是否只应该包含整数值:
if (data[0][col] instanceof Integer && !(value instanceof Integer))
{… } else { data[row][col] = value;}


然后,检查被插入的值是否是个整数。如果它不是的,那么这个字段就不应该被更新,而且应该要显示一条错误信息:
try {
data[row][col] = new Integer(value.toString());
} catch (NumberFormatException e) {
JOptionPane.showMessageDialog(SimpleTable.this,
"Please enter only integer values.");
}

背景颜色

Listing C包含了用于ColorTable.java的代码,它说明了如何向JTable加入颜色。你可以通过强制替代其prepareRenderer()方法来向JTable加入背景颜色:
JTable table = new JTable(data, columnNames){
   public Component prepareRenderer(TableCellRenderer r, int row, intcol){}
};

然后,插入决定哪些列应该有颜色以及应该是什么颜色的逻辑:
if (col == 2 && !isCellSelected(row, col)){
     Color bg = new Color(200, 100, 30);
     c.setBackground(bg);
c.setForeground(Color.white);
}


要注意,当你更改单元格背景颜色的时候,你还应该更该单元格里所显示的文本的颜色,让其变得更加易读。C显示了一个第一列和第二列加上了颜色的JTable。

图C



一切皆在掌握中

我们的例子只是JTable其他部分的基础。通过使用这些工具,你能够快速和轻易地掌控对Java应用程序所生成的表格的格式化,这样就能够让你的用户在进行正常使用的时候不碰到障碍。