在运行时设置JTable的选项

概述
Jtable类提供丰富的网格数据显示功能。这个技巧处理有关动态改变诸如滚动条，列宽以及行高等通常的外观的问题 。 (900 words; 九月14, 2001) （九月 20，2001译）

Java基础类(JFC)为创建一个精巧和交互的图形用户界面(GUIs)提供了丰富的组件选择。你可以使用javax.swing.JTable 显示表格式的数据。在这个技巧中，我们研究如何JTable 的常见问题。

首先让我们定义一个最初的，基本的Jtable类――MyTable:
import javax.swing.table.*;
import javax.swing.*;
import java.awt.*;
public class MyTable extends JTable{
      //缺省构造函数
      public MyTable(){
           super();
           }
      //使用指定的行列数创建表格的构造函数
        public MyTable(int row, int col){
            super(row, col);
            }
     }

相当简单！! 我们最初的 MyTable 实现就是一个普通的Jtable 。

下一节，我们将致力于不同的JTable 显示选项――例如滚动条，列宽，选择性以及其它一些属性。我们将扩充MyTable 并且合并一些不同的方法使得它支持我们想要的显示特性。每一节增加一个新方法到MyTable ，最后我们得到一个可完全复用的Jtable 。

滚动表格
首先，让我们的JTable 显示一些表格式的数据。我创建TableColumnTest示范Jtable 的能力:

import javax.swing.table.*;
import javax.swing.*;
import java.awt.event.*;
import java.awt.*;
/**Author Sonal Goyal, [e-mail]
*/
public class TableColumnTest{
    protected JFrame frame;
    protected JScrollPane scrollpane;
    protected MyTable table;
    public TableColumnTest(){
      //(1) 创建表格模型。
      DefaultTableModel dm = new DefaultTableModel();
      // 每列的名字
      String[] columnNames = {
            "This is going to be a really long column header",
            "Column B", "Column C", "Column D", "Column E", "Column F",
            "Column G", "Column H", "Column I",  "Column J"
            };

      // 实际的数据值
      Integer[][] data = new Integer[8][10];
      // 初始化数据矩阵。
      for (int row = 0; row < 8; row++){
            for (int col = 0; col < 10; ++col){
                  data[row][col] = new Integer(1000000);
            }
      }
      // 设置模型和数据及列头关联

      dm.setDataVector(data, columnNames);
      //(2) 创建表格
      table = new MyTable();
      //(3) 连接模型和表格
      table.setModel(dm);
      //(4) 为表格创建滚动面板
      scrollpane =  new JScrollPane(table);
      //(5) 显示表格
      frame =  new JFrame();
      frame.getContentPane().add(scrollpane);
      frame.setSize(200, 150);
      frame.setVisible(true);
  }
public static void main(String[] args){
       TableColumnTest test = new TableColumnTest();
}

示范程序相当简单。我们通过下面的步骤构造了一个简单的JTable:

·         创建并设置TableModel, 它包含行，列，列头以及数据数据的信息

• 创建并设置JTable, 它根据模型显示数据
• 将JTable 和第一步创建的模型关联

但是在这个代码里有一个曲解: 第四步加入了一个滚动面板。我们将构建的表格显示在一个Jframe里面; 参看图1

图 1. 杂乱的滚动

就像图1显示的那样，很难辨别任何列头或者是表格数据。虽然我们增加了滚动条，但水平滚动条没有显示。让我们详细的查看JTable 来揭示原因。JTable 有一个自动调整大小的模式，这将决定表格是否自动的调整列宽 (去覆盖表格的整个宽度) 以及如何进行调整。可以使用下面的值:

·         AUTO_RESIZE_OFF: 不自动调整列宽; 使用滚动条

• AUTO_RESIZE_NEXT_COLUMN: 当一列被调整，反向调整下一列
• AUTO_RESIZE_SUBSEQUENT_COLUMNS: 在调整时改变后续列以保持总的宽度
• AUTO_RESIZE_LAST_COLUMN: 在所有的调整操作上只将调整应用到最后一列
• AUTO_RESIZE_ALL_COLUMNS: 在所有的调整操作上成比例的调整所有的列。

缺省情况下，JTable 调整其它列以保持总的外观，就像图1说明的那样。因此，如果我们想用水平滚动条显示列，我们需要给MyTable 添加一个方法并在构造函数里面调用它:

/**这个方法在需要的时候显示水平滚动条

 * 两个构造函数都调用它
     */
     public void showHorScroll(boolean show){
      if (show){
          setAutoResizeMode(JTable.AUTO_RESIZE_OFF);
      }else{
          setAutoResizeMode(JTable.AUTO_RESIZE_SUBSEQUENT_COLUMNS);
      }
     }

图 2 显示了一个可见的水平滚动条:

图 2. 可见的水平滚动条

控制JTable 的列
你可以控制列的宽度，也可以使它们不可调整，这一节展示该如何做。

加宽列
通常你想让一个列必另一个更宽或更窄。要改变列的宽度，你可以使用TableColumnModel:

      /**这个方法设置pColumn指示的列的宽度为pWidth
       */
      public void setColumnWidth(int pColumn, int pWidth){
            //得到列的样式
            TableColumnModel colModel = getColumnModel();
            //得到pColumn列然后设置它的最佳宽度
                colModel.getColumn(pColumn).setPreferredWidth(pWidth);
      }

你也可以给Jframe增加一个按钮以及它的监听器,点击按钮改变表格的宽度:

    JButton resizeButton = new JButton("Resize Third Column");
    setResizeButton.addActionListener(this);
    public void actionPerformed(ActionEvent e){
      //检查是哪一个按钮被点击
          if (e.getActionCommand().equals("Resize Third Column")){
                 System.out.println("Resize called - resizes third column
    to 300");
                 table.setColumnWidth(2, 300);
                 //强制GUI刷新
                 table.invalidate();
                 frame.invalidate();
                 frame.validate();
                 frame.repaint();
            }

在这个例子中, pColumn 是列的索引值，pWidth 是新的列宽。点击Resize 按钮的效果显示为图3 和 4。

 

图 3. 点击前

 

 

图四 4. 点击后

不可变列
对于通常的应用，你可以拖动列头调整列的大小。下面的代码根据pIsResize 的值设置表格的调整性。如果pIsResize 为true, 列宽可以调整；否则不能:

    public void setResizable(int pColumn, boolean pIsResize){
      //得到列的样式
      TableColumnModel colModel = getColumnModel();
      //设置可调整性
      colModel.getColumn(pColumn).setResizable(pIsResize);
    }

在这个例子中， pColumn 是不可调整列的索引值。得到列(getColumn(..))然后设置一个简单的属性 (setResizable(..)) 就是全部要做的。

列的选择性
为什么不在点击按钮时选中整列而不只是一个单元？ JTable 通过调用单元的isCellSelected(int row, int col)方法显示该单元是否被选中。重载这个方法可以给你想要的结果，结果和传递到setSelect(int col, boolean select)的参数select有关。如果为false， 将不被选中。关键是将该列设置为colSelect(), 用"select" 标记指明该列是被选中还是取消选中:

   int colSelect;
    boolean select;
    /** 设置列col 为选中或取消选中
      * -根据select决定
     */
     public void setSelect(int col, boolean select){
      colSelect = col;
      this.select = select;
     }
    /**这个方法返回某个单元是否被选中
     */
    public boolean isCellSelected(int row, int column)
      throws IllegalArgumentException{
      //重载verride the method for the column set in setSelect()
      if (colSelect == column){
          if (select)
            return true;
          else
            return false;
      } else {
          return super.isCellSelected(row, column);
      }
    }

图 5 显示了Column D 被选中的结果。

 

图 5. 选中整列

控制列头
你可能注意到第一列列头的长度比列宽大。我们通过重设列宽来处理这个:

/**根据列头文本的宽度设置列头和列的大小
*/
public void setHeaderSize(int pColumn){
      //得到指定列的名字
      String value =  getColumnName(pColumn);
      //计算列宽
      FontMetrics metrics = getGraphics().getFontMetrics();
      int width = metrics.stringWidth(value) +
(2*getColumnModel().getColumnMargin());
      //设置宽度
      setColumnWidth(pColumn, width);
}

上面的代码被执行后重设列头的结果显示在图6中。

 

图 6. 完全可见的列头

特性丰富的JTable
在这个技巧中，我们在简单的Jtable 上测试了不同的选项,并且在表格被显示后改变那些选项。在这个过程中，我们开发了一个能提供丰富的用户界面能力的表格。研究 的其它属性看看你能创建一个什么样的有趣表格!