javax.swing
类 JList

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JList

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

public class JList
     

      extends 
      JComponent
     
     

      implements 
      Scrollable, 
      Accessible
     

显示对象列表并且允许用户选择一个或多个项的组件。单独的模型 ListModel 维护列表的内容。

使用能自动构建只读 ListModel 实例的 JList 构造方法，可以方便地显示对象数组或对象 Vector：

 // Create a JList that displays strings from an array

 String[] data = {"one", "two", "three", "four"};
 JList myList = new JList(data);

 // Create a JList that displays the superclasses of JList.class, by
 // creating it with a Vector populated with this data

 Vector superClasses = new Vector();
 Class rootClass = javax.swing.JList.class;
 for(Class cls = rootClass; cls != null; cls = cls.getSuperclass()) {
     superClasses.addElement(cls);
 }
 JList myList = new JList(superClasses);
 
 // The automatically created model is stored in JList's "model"
 // property, which you can retrieve

 ListModel model = myList.getModel();
 for(int i = 0; i < model.getSize(); i++) {
     System.out.println(model.getElementAt(i));
 }
 

可通过构造方法或 setModel 方法向 JList 直接提供 ListModel。内容不需要是静态的，即项数和项值可以随时间而更改。正确的 ListModel 实现在每次发生更改时通知已添加到其中的 javax.swing.event.ListDataListener 集合。这些更改的特性由标识已修改、已添加或已移除的列表索引范围的 javax.swing.event.ListDataEvent 来描述。通过侦听该模型，JList 的 ListUI 负责保持可视化表示形式与更改一致。

简单的、动态内容的 JList 应用程序可以使用 DefaultListModel 类维护列表元素。此类实现 ListModel 接口，它还提供类似于 java.util.Vector 的 API。而需要自定义 ListModel 实现的应用程序可能希望子类化 AbstractListModel，它提供对管理和通知侦听器的基本支持。例如，AbstractListModel 的一个只读实现：

 // This list model has about 2^16 elements.  Enjoy scrolling.

 ListModel bigData = new AbstractListModel() {
     public int getSize() { return Short.MAX_VALUE; }
     public Object getElementAt(int index) { return "Index " + index; }
 };
 

JList 的选择状态由另一个独立模型（ListSelectionModel 的一个实例）进行管理。JList 在构造时使用选择模型初始化，它还包含要查询或设置此选择模型的方法。此外，JList 提供了便捷的方法，可以很容易地管理选择。这些方法（如 setSelectedIndex 和 getSelectedValue）是维护与选择模型交互细节的覆盖方法。默认情况下，JList 的选择模型配置为允许一次选择项的任何组合；选择模式为 MULTIPLE_INTERVAL_SELECTION。选择模式可以在选择模型上进行直接更改，或者通过 JList 的覆盖方法更改。更新选择模型以响应用户动作的责任取决于列表的 ListUI。

正确的 ListSelectionModel 实现在每次选择发生更改时通知向其添加的 javax.swing.event.ListSelectionListener 集合。这些更改的特征由标识选择更改范围的 javax.swing.event.ListSelectionEvent 来描述。

侦听列表选择中更改的首选方法是向 JList 中直接添加 ListSelectionListener。然后，JList 负责侦听选择模型并向侦听器通知更改。

侦听选择更改以便使列表可视化表示形式保持最新的责任取决于列表的 ListUI。

绘制 JList 中的单元由称为单元渲染器（以 cellRenderer 属性的形式安装在列表上）的委托进行处理。渲染器提供一个其用法类似 "rubber stamp" 的 java.awt.Component 来绘制单元。每当需要绘制单元时，列表的 ListUI 就请求组件的单元渲染器，将其移动到位，然后通过其 paint 方法绘制单元的内容。默认单元渲染器（它使用 JLabel 组件呈现）由列表的 ListUI 安装。用户还可以使用如下代码替换自己的渲染器：

  // Display an icon and a string for each object in the list.

 class MyCellRenderer extends JLabel implements ListCellRenderer {
     final static ImageIcon longIcon = new ImageIcon("long.gif");
     final static ImageIcon shortIcon = new ImageIcon("short.gif");

     // This is the only method defined by ListCellRenderer.
     // We just reconfigure the JLabel each time we're called.

     public Component getListCellRendererComponent(
       JList list,              // the list
       Object value,            // value to display
       int index,               // cell index
       boolean isSelected,      // is the cell selected
       boolean cellHasFocus)    // does the cell have focus
     {
         String s = value.toString();
         setText(s);
         setIcon((s.length() > 10) ? longIcon : shortIcon);
         if (isSelected) {
             setBackground(list.getSelectionBackground());
             setForeground(list.getSelectionForeground());
         } else {
             setBackground(list.getBackground());
             setForeground(list.getForeground());
         }
         setEnabled(list.isEnabled());
         setFont(list.getFont());
         setOpaque(true);
         return this;
     }
 }

 myList.setCellRenderer(new MyCellRenderer());
 

单元渲染器的另一项工作是帮助确定列表的大小信息。默认情况下，列表的 ListUI 通过请求单元渲染器提供每个列表项的首选大小来确定单元的大小。对于大的项列表，这可能开销很大。为了避免这些计算，可以在列表上设置 fixedCellWidth 和 fixedCellHeight，或者根据单个原型值自动计算这些值：

 JList bigDataList = new JList(bigData);

 // We don't want the JList implementation to compute the width
 // or height of all of the list cells, so we give it a string
 // that's as big as we'll need for any cell.  It uses this to
 // compute values for the fixedCellWidth and fixedCellHeight
// properties.

 bigDataList.setPrototypeCellValue("Index 1234567890");
 

 JScrollPane scrollPane = new JScrollPane(myList);

 // Or in two steps:
 JScrollPane scrollPane = new JScrollPane();
 scrollPane.getViewport().setView(myList);
 

 MouseListener mouseListener = new MouseAdapter() {
     public void mouseClicked(MouseEvent e) {
         if (e.getClickCount() == 2) {
             int index = list.locationToIndex(e.getPoint());
             System.out.println("Double clicked on Item " + index);
          }
     }
 };
 list.addMouseListener(mouseListener);
 

警告：Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

有关更多文档，请参阅 The Java Tutorial 中的 How to Use Lists。另请参见 The Swing Connection 中的文章 Advanced JList Programming。 　

另请参见：

ListModel, AbstractListModel, DefaultListModel, ListSelectionModel, DefaultListSelectionModel, ListCellRenderer, DefaultListCellRenderer