概述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, sonal_goyal@hotmail.com*/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 上测试了不同的选项,并且在表格被显示后改变那些选项。在这个过程中,我们开发了一个能提供丰富的用户界面能力的表格。研究JTable's 的其它属性看看你能创建一个什么样的有趣表格!