在JTable单元格上 加入组件,并赋予可编辑能力 [转]

对于JTable单元格的渲染主要是通过两个接口来实现的,一个是TableCellRenderer另一个是TableCellEditor,JTable默认是用的是DefaultCellRenderer和DefaultCellEditor,这两个都是在类似JTextfield的一个JComponent的基础上来实现的,如果我们需要在JTable的单元格内放置特殊的控件或者绘制出特殊的效果,就要实现TableCellRenderer和TableCellEditor接口,在其上绘制出自己需要的样式,再通过JTable的setCellRenderer和setCellEditor方法设置新的外观呈现.

首先我们先看看TableCellRenderer和TableCellEditor接口的区别, TableCellRenderer接口就是用来绘制和展示当前单元格的内容的,可以用文字、图片、组件、甚至Java2D来绘制效果; TableCellEditor主要是用来当用户点击具体的某个单元格进行编辑的时候来展现的,除了绘制之外,在点击时还会有更加复杂的效果出现.

先看Sun官方给的简单的例子,首先是TableCellRenderer的

运行图示如下:

 

我们只需要实现TableCellRenderer就可以了,

/**

 * This interface defines the method required by any object * that would like to be a renderer for cells in a JTable

 * in there, I put button in it.

*/

publicclass MyButtonRenderer extends JButton implements TableCellRenderer {

实现接口的方法:

    @Override

    public Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column) {

然后设置属性：

setForeground(table.getSelectionForeground());

       setBackground(table.getSelectionBackground());

setText((value == null) ? "" : value.toString());

使用也很简单,假如我们希望第一列是JButton,则

table.getColumnModel().getColumn(0).setCellRenderer(new MyButtonRenderer());

接着是TableCellEditor的实现,还是Sun给的例子:

运行图示如下

 

Sun公司在DefaultCellEditor类里提供了JComboBox参数的构造函数,直接使用就可以了.

   //Set up the editor for the sport cells.

   JComboBox comboBox = new JComboBox();

   comboBox.addItem("Snowboarding");

   comboBox.addItem("Rowing");

   comboBox.addItem("Knitting");

   comboBox.addItem("Speed reading");

   comboBox.addItem("Pool");

   comboBox.addItem("None of the above");

table.getColumnModel().getColumn(2).setCellEditor(new DefaultCellEditor(comboBox));

在这里看来,这个例子就可以了,但是它还是有问题的,什么问题呢,看下截图:

 

当JTable的单元格比较短时,下拉框显示的内容会出现不全的情况,需要修改一下:

问题在哪儿呢,在于JCombobox的UI,需要设置一下JCombobox的下拉菜单的宽度,具体实现在JCombobox那篇文章里已经实现了,这里我们直接使用,

        String[] str = new String[] { "Snowboarding", "Rowing", "Knitting", "Speed reading", "None of the above" };

        MyComboBox combo = new MyComboBox(str);

        Dimension d = combo.getPreferredSize();

        combo.setPopupWidth(d.width);

        table.getColumnModel().getColumn(2).setCellEditor(newDefaultCellEditor(combo));

运行如下图:

 

到此为止,Renderer和Editor的简单实用就完成了,这些例子都是Sun官方给的,我大概

修改了一下,其实还有问题.

让我们回头看第一个例子:

当鼠标在JButton按下时,如下图:

 

JButton的效果消失了,因为Renderer只是处理表示的样式,对于可编辑的单元格就不可

以了,编辑状态下呈现的还是默认的JTextField组件,所以对于可编辑的单元格,我们需

要设置它的Editor.

我们需要写一个自己的Editor,为了简单就不实现TableCellEditor接口了,只需要继

承DefaultCellEditor.

/**

 * The default editor for table and tree cells.

 */

publicclass MyButtonCellEditor extends DefaultCellEditor {

 

定义两个属性：

    //editor show

    private JButton button = null;

    //text

private String label = null;

分别代表编辑状态下显示的组件和显示的值.

然后重写getTableCellEditorComponent方法,在编辑状态表示我们自己的组件.

    /**

     * Sets an initial <code>value</code> for the editor.

     */

    @Override

public Component getTableCellEditorComponent(JTable table, Object value, boolean isSelected, int row, int column) {

设置组件样式:

   button.setForeground(table.getSelectionForeground());

   button.setBackground(table.getSelectionBackground());

   label = (value == null) ? "" : value.toString();

   button.setText(label);

   returnbutton;

然后还需要重写getCellEditorValue方法,返回编辑完成后的值,

@Override

    public Object getCellEditorValue() {

        returnnew String(label);

}

使用和以前设置Renderer和Editor一样,设置2个就可以了.

table.getColumnModel().getColumn(0).setCellRenderer(new MyButtonRenderer());

table.getColumnModel().getColumn(0).setCellEditor(new MyButtonCellEditor());

最后按下效果正常了:

 

到此为止,简单的Renderer和Editor就差不多了,但是我们在JTable放置的都是基本的Swing组件,可不可以放置复杂的呢,当然是可以的,下面我们放置一个选择组:

如下图:

 

它也需要实现自己的Renderer和Editor,我们可以把这个显示选择按钮组的单元格看做一个组件,当然首先就是把这个组件作出来:

/**

 * create the pane that some radio pane in it.

*/

publicclass MyRadioPanel extends JPanel {

它只有一个属性,根据给定数组长度构建Radio数组,

    /** radio button group. */

    private JRadioButton[] buttons = null;

再看它的构造函数:

    public MyRadioPanel(String[] strButtonText) {

我们在这里构造JRadioButton：

buttons[i] = new JRadioButton(strButtonText[i]);

加入到面板:

add(buttons[i]);

再添加取得和设置JRadioButton选择的方法:

    /**

     * get button groups.

     */

    public JRadioButton[] getButtons() {

       returnbuttons;

    }

    /**

     * set which index select.

     */

    publicvoid setSelectedIndex(int index) {

       for (int i = 0; i < buttons.length; i++) {

           buttons[i].setSelected(i == index);

       }

    }

然后就是写Renderer了,我们继承MyRadioPanel并且实现TableCellRenderer接口就可以了.

publicclass MyRadioCellRenderer extends MyRadioPanel implements

       TableCellRenderer {

构造函数直接使用MyRadioCellRenderer的

    public MyRadioCellRenderer(String[] strButtonTexts) {

       super(strButtonTexts);

    }

然后是实现接口的getTableCellRendererComponent方法:

    @Override

    public Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column) {

       if (value instanceof Integer) {

           setSelectedIndex(((Integer) value).intValue());

       }

       returnthis;

}

最后就是Editor了,

/**

 * create cell editor that radio in it.

*/

publicclass MyRadioCellEditor extends DefaultCellEditor implements

       ItemListener {

在它的构造函数里我们为JRadioButton添加监听:

JRadioButton[] buttons = panel.getButtons();

buttons[i].addItemListener(this);

在监听处理中我们停止编辑,

    @Override

    publicvoid itemStateChanged(ItemEvent e) {

       super.fireEditingStopped();

    }

然后我们需要覆盖DefaultCellEditor的getTableCellEditorComponent,返回我们需要显示的MyRadioPanel.

    @Override

    public Component getTableCellEditorComponent(JTable table, Object value,

           boolean isSelected, int row, int column) {

       if (value instanceof Integer) {

           panel.setSelectedIndex(((Integer) value).intValue());

       }

       returnpanel;

    }

最后我们重写getCellEditorValue,返回编辑完成后我们显示的值：

@Override

    public Object getCellEditorValue() {

       returnnew Integer(panel.getSelectedIndex());

    }

使用也很简单,和前面设置Renderer和Editor一样:

String[] answer = { "A", "B", "C" };

table.getColumnModel().getColumn(1).setCellRenderer(

      new MyRadioCellRenderer(answer));

table.getColumnModel().getColumn(1).setCellEditor(

      new MyRadioCellEditor(newMyRadioCellRenderer(answer)));

接下来我们看一个比较综合的例子,首先还是从画面开始:

 

先从简单的开始做起,首先使JTable的第三列显示成进度条,这个和前面的设置Renderer一样,实现TableCellRenderer就可以了.

/**

 * This interface defines the method required by any object * that would like to be a renderer for cells in a JTable

 * in there, I put progress bar in it.

*/

publicclass MyProgressCellRenderer extends JProgressBar implements

       TableCellRenderer {

它提供一个属性放置各个颜色区间需要设置的颜色:

    /** the progress bar‘s color. */

    private Hashtable<Integer, Color> limitColors = null;

在构造函数里我们设置显示的最大和最小值:

    /**

    * Creates a progress bar using the specified orientation, * minimum, and maximum.

     */

    public MyProgressCellRenderer(int min, int max) {

       super(JProgressBar.HORIZONTAL, min, max);

       setBorderPainted(false);

    }

然后实现TableCellRenderer接口的getTableCellRendererComponent方法，设置显示组件和颜色:

    @Override

    public Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column) {

先根据单元格的值取得颜色:

        Color color = getColor(n);

       if (color != null) {

           setForeground(color);

       }

同时设置JProcessBar的值并返回它.

       setValue(n);

       returnthis;

最后还提供一个设置颜色的方法:

publicvoid setLimits(Hashtable<Integer, Color> limitColors) {

它把传入的颜色表按照大小先排序,然后设置好.

这样一个简单的显示进度条的TabelCellRenderer就完成了.然后通过setRenderer来使用它.

//create renderer.

 MyProgressCellRenderer renderer = new MyProgressCellRenderer(

        MyProgressTableModel.MIN, MyProgressTableModel.MAX);

 renderer.setStringPainted(true);

 renderer.setBackground(table.getBackground());

 // set limit value and fill color

 Hashtable<Integer, Color> limitColors = new Hashtable<Integer, Color>();

 limitColors.put(new Integer(0), Color.green);

 limitColors.put(new Integer(20), Color.GRAY);

  limitColors.put(new Integer(40), Color.blue);

 limitColors.put(new Integer(60), Color.yellow);

 limitColors.put(new Integer(80), Color.red);

 renderer.setLimits(limitColors);

 //set renderer      table.getColumnModel().getColumn(2).setCellRenderer(renderer);

然后我们需要考虑的是这个Renderer的值无法变化,只能根据初始化的时候的数值显示,这明显是不行的,所以我们考虑给JTable加上改变,改变第二列的数字,第三列进度条随之改变,如图示:

 

 

这时我们需要修改我们的TableModel,默认的已经无法满足我们的需要了,我们需要自己写一个:

publicclass MyProgressTableModel extends DefaultTableModel {

在它的构造函数里面,我们增加一个监听:

this.addTableModelListener(new TableModelListener() {

           @Override

           publicvoid tableChanged(TableModelEvent e) {

当引起TableModel改变的事件是UPDATE时并且是第二列时候:

     //when table action is update.

    if (e.getType() == TableModelEvent.UPDATE) {

          int col = e.getColumn();

          if (col == 1) {

我们取得新设立的value,赋予第三列:

    //get the new set value.

    Integer value = (Integer) model.getValueAt(row, col);

    model.setValueAt(checkMinMax(value), row, ++col);

重写isCellEditable方法,设置可编辑的列:

    @Override

    publicboolean isCellEditable(int row, int col) {

       switch (col) {

       case 1:

           returntrue;

       default:

           returnfalse;

       }

    }

重写setValueAt方法,设置可赋予的值:

    @Override

    publicvoid setValueAt(Object obj, int row, int col) {

这样一个我们需要的TableModel就完成了,修改第二列的值,第三列进度条也随之改变,使用也很简单:

        // set the table model.

        table.setModel(dm);

就可以了.

到这里,这个进度条JTable基本完成了,但是在实际运用中可能会出现这样的问题:

 

我们编辑JTable的时候给它的单元格赋予了一个不正常的值,导致显示不正常,但是却无法返回旧有的状态,这样我们就需要再次改进它:

当输入错误的值时:

 

然后可以返回以前的状态:

 

这时候我们需要设置的是第二列的Editor,使它编辑状态时可以验证我们的输入,并触发:

/**

 * Implements a cell editor that uses a formatted text

 * field to edit Integer values.

 */

publicclass MyIntegerEditor extends DefaultCellEditor {

它有一个参数,用来处理编辑值的:

    //show component when cell edit

    private JFormattedTextField ftf;

然后重写DefaultCellEditor的getTableCellEditorComponent方法,返回我们定义的JFormattedTextField.

JFormattedTextField ftf = (JFormattedTextField) super

.getTableCellEditorComponent(table, value, isSelected, row, column); ftf.setValue(value);

return ftf;

重写getCellEditorValue方法,保证我们返回值正确：

getCellEditorValue

 @Override

    public Object getCellEditorValue() {

取得编辑完成的值:

    Object o = ftf.getValue();

判断然后返回.

然后重写stopCellEditing方法,判断编辑的值是否正确,不正确的情况下提示用户,询问用户是返回还是重新设置.

    // Override to check whether the edit is valid,

    // setting the value if it is and complaining if it isn‘t.

    @Override

    publicboolean stopCellEditing() {

        JFormattedTextField ftf = (JFormattedTextField) getComponent();

        if (ftf.isEditValid()) {

            try {

                ftf.commitEdit();

            } catch (java.text.ParseException exc) {

            }

        } else { // text is invalid

            if (!userSaysRevert()) {

                // user wants to edit don‘t let the editor go away

                returnfalse;

            }

        }

        returnsuper.stopCellEditing();

    }

到目前为止,这个类基本完成了,但是只有焦点离开单元格才触发验证事件,比较不和逻辑,我们加入一个键盘监听,回车也可以触发.

ftf.getInputMap().put(KeyStroke.getKeyStroke(KeyEvent.VK_ENTER, 0), "check");

ftf.getActionMap().put("check", new AbstractAction() {

@Override

      publicvoid actionPerformed(ActionEvent e) {

           // The text is invalid.

           if (!ftf.isEditValid()) {

               if (userSaysRevert()) {

                   // reverted inform the editor

                   ftf.postActionEvent();

               }

            } else

               try {

                   // The text is valid, so use it.

                   ftf.commitEdit();

                   // stop editing

                   ftf.postActionEvent();

                } catch (java.text.ParseException exc) {

                }

      }

然后就可以使用它了,和前面设置一个Editor一样:

   table.getColumnModel().getColumn(1).setCellEditor(

        new MyIntegerEditor(MyProgressTableModel.MIN,

                        MyProgressTableModel.MAX));

到目前为止,JTable的Renderer和Editor就完成了,实际使用中也就这样了,但是还有一种特殊情况需要说一下,虽然这样变态需求一般现实中很难碰到.上面我们所有的例子都是对某一个列来说的,但是如果有人需要第一行显示正常单元格,第二行显示JCombobox,第三行显示JButton怎么处理呢.其实也相差不大,自己写个Renderer和Editor,里面实现一个Renderer和Editor的序列,依次展现就可以了.

先看图:

 

 

首先要做的写一个类实现TableCellEditor接口,

publicclass MyCellEditor implements TableCellEditor {

它有两个属性:

    /** save all editor to it. */

    private Hashtable<Integer, TableCellEditor> editors = null;

    /** each cell editor. */

    private TableCellEditor editor = null;

分别存储了此Editor上所有的Editor队列和当前需要使用的Editor.

再看它的构造函数,

    /**

     * Constructs a EachRowEditor. create default editor

     */

    public MyCellEditor(JTable table) {

它初始化了Editor队列

editors = new Hashtable<Integer, TableCellEditor>();

然后实现TableCellEditor接口的getTableCellEditorComponent方法

    @Override

    public Component getTableCellEditorComponent(JTable table, Object value, boolean isSelected, int row, int column) {

根据行号取得当前单元格的Editor：

editor = (TableCellEditor) editors.get(new Integer(row));

没有的话,使用默认的:

if (editor == null) {

            editor = new DefaultCellEditor(new JTextField());

        }

然后返回当前Renderer下的单元格:

     returneditor.getTableCellEditorComponent(table, value, isSelected, row, column);

接着实现stopCellEditing、cancelCellEditing、addCellEditorListener、

removeCellEditorListener、isCellEditable、shouldSelectCell方法,

在这些方法里取得当前那个单元格被编辑,取得正编辑的单元格的Editor,再调用Editor

同样的方法就可以了.

       if (e == null) {

          row = table.getSelectionModel().getAnchorSelectionIndex();

        } else {

            row = table.rowAtPoint(e.getPoint());

        }

        editor = (TableCellEditor) editors.get(new Integer(row));

        if (editor == null) {

            editor = new DefaultCellEditor(new JTextField());

        }

最后提供一个设置单元格Editor的方法,

    /**

     * add cell editor to it.

     */

    publicvoid setEditorAt(int row, TableCellEditor editor) {

        editors.put(new Integer(row), editor);

    }

这样可以实现单元格级别的Editor就实现了,同样的Renderer也一样,同样实现TableCellRenderer接口和它里面的方法就可以了,同样用对列存储每个单元格的Renderer,这里就不写了.

最后是使用:

先创建JTable需要用到的Editor,再创建单一Cell用到的Editor,

 //create all cell editor

 MyCellEditor rowEditor = new MyCellEditor(table);

  //create cell editors

  MyButtonCellEditor buttonEditor = new MyButtonCellEditor();

 DefaultCellEditor comboBoxEditor = new

DefaultCellEditor(comboBox);

然后为需要的单元格设置Editor,

 //put cell editor in all cell editors

 rowEditor.setEditorAt(0, comboBoxEditor);

 rowEditor.setEditorAt(1, comboBoxEditor);

 rowEditor.setEditorAt(2, buttonEditor);

 rowEditor.setEditorAt(3, buttonEditor);

最后设置JTable的Editor,

 //set table editor

 table.getColumnModel().getColumn(0).setCellEditor(rowEditor);

同样的,Renderer和Editor完全一样.这样一个可以为具体单元格设置Renderer和Editor的例子就完成了.

到此为止,关于在JTable的单元格放置组件的例子就全部完成了,总结起来也很简单,就是设置Renderer和Editor,至于更复杂的效果,比如合并单元格之类的,就需要重写JTable的TableUI了，这就在以后说了