内容: 1。绘制器的工作原理。 2。用自订的绘制器更换JList和JComboBox的外观。 3。让新的外观响应鼠标事件。
借助swing体系的mvc设计理念,为组件更换不同的外观成为轻而易举的事情。本文主要以JList和JComboBox为例讲解ListCellRenderer的原理与用法.
一、绘制器的工作原理 不管是JList还是JComboBox,它们都用到了ListCellRenderer,因为JComboBox本身就是由一个下拉式的JList和TextField组成的. 在这里,它们使用了callback的机制。
callback的一是种常见的方式是在A类中调用B类中的方法,在A类中先要登记一个(也可以是多个)B类的实例引用,在需要调用时再通过该实例来调用它的内部方法.这样的机制在很多的设计模式中都有用到,如Observer等.还有AWT的事件机制也用到了callback.
要实现callback,通常将B类设计成一个能被callback的接口.在JList的绘制器中,swing提供了一个ListCellRenderer接口, public interface ListCellRenderer { Component getListCellRendererComponent( JList list, Object value, int index, boolean isSelected, boolean cellHasFocus); } 这个接口只提供一个方法,我们只要实现了这个接口,并将它的实例引用传给JList,就可以将JList替换成不同的样式了.看一下ListCellRenderer是如何工作的,
 在绘制JList的每个Cell之前,它会去调用getListCellComponent( ),得到一个Component,并 将这个Component绘制在正确的位置.因为getListCellComponent( )返回的是Component,所以我们几乎可以扩展任意一个Component,来改变JList,JComboBox等的外观.
二、制作自已的绘制器 我们现在要想让JList中显示一组学生名单,同时每个名单前显示该学生的图标.如下图所示
 我们先来想一想,Swing中有什么组件既可以显示图标也可以显示文字? JLabel.对了。我们就用JLabel作为JList的绘制器, 看看我扩展的JLabel类,它实现了ListCellRenderer接口: /* 可以显示图标的ListCell绘制器 */ public class IconListItemRenderer extends JLabel implements ListCellRenderer { private Border selectedBorder = BorderFactory.createLineBorder(Color.blue,1), emptyBorder = BorderFactory.createEmptyBorder(1,1,1,1);
public Component getListCellRendererComponent( JList list, Object value, int index, boolean isSelected, boolean cellHasFocus) {
IconListItem item = (IconListItem)value; this.setIcon(item.getIcon()); this.setText(item.getText());
if ( isSelected ) setBorder (selectedBorder); else setBorder(emptyBorder); return this; } } 大家看到,getListCellRendererComponent方法会传入几个参数,我们就用它传入的几个参数设置JLabel的外观:图标与文字。在这个类中,我们用一个IconListItem接收调用者传过来的value, IconListItem item = (IconListItem) value; IconListItem是我另外定义好的一个类,它用来存放每一个List Item的值, import javax.swing.*; public class IconListItem { Icon icon; String text; public IconListItem(Icon icon, String text) { this.icon = icon; this.text = text; } public Icon getIcon() { return icon;} public String getText() { return text;} public void setIcon(Icon icon){ this.icon = icon;} public void setText(String text){ this.text = text; } } 这样的话,我就可以用getIcon()和getText()方法取得每个List Item的值了, IconListItem item = (IconListItem) value; this.setIcon(item.getIcon()); this.setText(item.getText());
至此,我们就可以用以下方法方便的更换JList的外观了, JList list = new JList(); list.setCellRenderer(new IconListItemRenderer()); file://安装我们自订的cellRenderer DefaultListModel listModel = new DefaultListModel(); list.setModel(listModel); IconListItem item = new IconListItem(new ImageIcon(...),"John"); listModel.addElement(item); // 为List增加Item ... 由于JComboBox也有一个下拉式清单,所以它的清单也是用ListCellRenderer来绘制的,所以我们也可以将这个IconListItemRenderer给它用: JComboBox list = new JComboBox(); list.setRenderer(new IconListItemRenderer()); //装我们自订的cellRenderer DefaultComboBoxModel comboModel = new DefaultComboBoxModel(); list.setModel(comboModel); IconListItem item = new IconListItem(new ImageIcon(...),"John"); comboModel.addElement(item); // 为List增加Item ... 注意,JComboBox安装绘制器时是用setRenderer()方法,JList是用setCellRenderer()方法,名字稍有不同.
以上大家看到的是可显示一个图标的List, 下面我们再看一个可显示CheckBox的List是如何实现的,以下是例图:
 代码实现: import javax.swing.*; import java.awt.*; import javax.swing.border.*; import java.awt.event.*; /* 可以显示CheckBox的ListCell绘制器 */ public class CheckListItemRenderer extends JCheckBox implements ListCellRenderer { public Component getListCellRendererComponent( JList list, Object value, int index, boolean isSelected, boolean cellHasFocus) { CheckListItem item = (CheckListItem)value; this.setSelected(item.getCheck()); this.setText(item.getText()); this.setFont(list.getFont()); this.setEnabled(list.isEnabled()); return this; } } 同样这个绘制器中用一个CheckListItem存放每个List Item的值: public class CheckListItem { boolean check; String text; public CheckListItem(boolean check, String text) { this.check = check; this.text = text; } public boolean getCheck() { return check; } public void setCheck(boolean _check) { check = _check; } public String getText() { return text; } public void setText(String _text) { text = _text; } } 这个绘制器的用法同IconListItemRenderer一样,不多讲了.
三、让自订的绘制器响就鼠标事件 使用以上的CheckListItemRenderer时,大家会发现,虽然List中可以显示CheckBox了,但是用鼠标点击时,没有反应! 现在我就来解决这个问题.要澄清的是,ListCellRenderer本身是只返回一个组件用来绘制一个单元格,不能对用户动作作出反应。为些我们必须在JList上下功夫.JList有一个addMouseListener()方法可以为自身安装一个鼠标监听器,在这里,我实现了一个MouseAdapter,并让它对mousePressed作出响应: class CheckListMouseListener extends MouseAdapter { public void mousePressed(MouseEvent e) { JList list = (JList) e.getSource(); int index = list.locationToIndex(e.getPoint()); CheckListItem item = (CheckListItem)list.getModel().getElementAt(index); item.setCheck(! item.getCheck()); Rectangle rect = list.getCellBounds(index, index); list.repaint(rect); } } 使用时, 用addMouseListener(new CheckListMouseListener())就行了.
除了包含CheckBox的JList外,许多情况下,我们需要为自制的绘制器加上动作响应,如我们要实现一个可编辑的JList, 除了要扩展JTextField及实现ListCellRenderer之外,还要写一个鼠标监听器和键盘监听器,当双击时,JList变成可编辑状态,当回车时,还原成不可编辑状态.具体的实现过程,我就不详叙了,留给大家作练习.
上面内容,我写了一个演示程序,下面是它的演示画面,
 你可以从这里下载完整的演示程序.
以上文章为Turbo Chen原作,版权所有。如需转载,请注明来源.

|