Java javax.swing 类 JList（JDK5）

所有类

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 构造方法，可以方便地显示对象的数组或向量：

 // Create a JList that displays the strings in data[]

 String[] data = {"one", "two", "three", "four"};
 JList dataList = new JList(data);
 
 // The value of the JList model property is an object that provides
 // a read-only view of the data.  It was constructed automatically.

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

 // Create a JList that displays the superclass of JList.class.
 // We store the superclasses in a java.util.Vector.

 Vector superClasses = new Vector();
 Class rootClass = javax.swing.JList.class;
 for(Class cls = rootClass; cls != null; cls = cls.getSuperclass()) {
     superClasses.addElement(cls);
 }
 JList classList = new JList(superClasses);
 

JList 不支持直接滚动。要创建滚动列表，需要让 JList 作为 JScrollPane 的视口视图。例如：

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

默认情况下，JList 选择模型允许使用常量 MULTIPLE_INTERVAL_SELECTION 一次选择任何项的组合。选择状态由单独的委托对象（即 ListSelectionModel 的实例）实际管理。不过，JList 提供了便捷的属性，可用于管理选择。

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

 dataList.setSelectedIndex(1);  // select "two"
 dataList.getSelectedValue();   // returns "two"
 

JList 的内容可以是动态的，换句话说，在创建 JList 之后，列表元素可以改变值，列表的大小也可以改变。JList 利用 swing.event.ListDataListener 实现在其模型中观察更改。正确实现的 ListModel 在每次发生更改时向其侦听器发出通知。更改的特征由标识已修改、已添加或已移除的列表索引范围的 swing.event.ListDataEvent 来描述。简单动态内容 JList 应用程序可以使用 DefaultListModel 类存储列表元素。此类实现 ListModel 接口，同时提供 java.util.Vector API。需要提供自定义 ListModel 实现的应用程序可以为提供基本 ListDataListener 支持的 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 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");
 

  // 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,
       Object value,            // value to display
       int index,               // cell index
       boolean isSelected,      // is the cell selected
       boolean cellHasFocus)    // the list and the cell have the 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;
     }
 }

 String[] data = {"one", "two", "three", "four"};
 JList dataList = new JList(data);
 dataList.setCellRenderer(new MyCellRenderer());
 

 final JList list = new JList(dataModel);
 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 版本的应用程序之间的 RMI。从 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

VERTICAL

public static final int VERTICAL

指示默认布局：一列单元。

从以下版本开始：

1.4

另请参见：

setLayoutOrientation(int), 常量字段值

VERTICAL_WRAP

public static final int VERTICAL_WRAP

指示“报纸样式”布局，单元按先纵向后横向流动。

从以下版本开始：

1.4

另请参见：

setLayoutOrientation(int), 常量字段值

HORIZONTAL_WRAP

public static final int HORIZONTAL_WRAP

指示“报纸样式”，单元按先横向后纵向流动。

从以下版本开始：

1.4

另请参见：

setLayoutOrientation(int), 常量字段值

JList

public JList(ListModel dataModel)

构造一个 JList，使其使用指定的非 null 模型显示元素。所有 JList 构造方法都委派给此方法。

参数：

dataModel - 此列表的数据模型

抛出：

IllegalArgumentException - 如果 dataModel 为 null

JList

public JList(Object[] listData)

构造一个 JList，使其显示指定数组中的元素。此构造方法仅委派给 ListModel 构造方法。

参数：

listData - 要加载到数据模型中的 Object 的数组

JList

public JList(Vector<?> listData)

构造一个 JList，使其显示指定 Vector 中的元素。此构造方法仅委派给 ListModel 构造方法。

参数：

listData - 要加载到数据模型中的 Vector

JList

public JList()

构造一个使用空模型的 JList。

getUI

public ListUI getUI()

返回呈现此组件的外观 (L&F) 对象。

返回：

呈现此组件的 ListUI 对象

setUI

public void setUI(ListUI ui)

设置呈现此组件的外观 (L&F) 对象。

参数：

ui - ListUI L&F 对象

另请参见：

UIDefaults.getUI(javax.swing.JComponent)