P31 JList列表框

傷城~ 2024-04-06 09:50 53阅读 0赞

#### P31 JList列表框 ####

*  1.概述
 *  2.代码实例
 *  3.效果展示

> 系统：Win10  
> Java：1.8.0\_333  
> IDEA：2020.3.4  
> Gitee：[https://gitee.com/lijinjiang01/JavaSwing][https_gitee.com_lijinjiang01_JavaSwing]

## 1.概述 ##

**JList**：列表框。JList 以列表的形式展示多个选项，允许用户选择一个或多个选项。其中的选项内容由一个 ListModel 实例来维护。JList 不实现直接滚动，需要滚动显示，可以结合 JScrollPane 实现滚动效果。  
JList 常用构造方法：

/**
     * 一个 JList 实例维护这一个 ListModel 实例。
     * ListModel 实例可以直接创建，也可以通过把 数组 或 集合 传递到 JList 中间接创建。
     */
    JList()
    
    JList(ListModel dataModel)
    
    JList(Object[] listData)
    
    JList(Vector<?> listData)

JList 选项数据 相关方法：

// 以数组形式设置选项数据，内部将自动封装成 ListModel
    void setListData(Object[] listData)
    
    // 以集合形式设置选项数据，内部将自动封装成 ListModel
    void setListData(Vector<?> listData)
    
    // 直接设置选项数据的 ListModel
    void setModel(ListModel<?> model)
    
    // 获取维护选项数据的 ListModel。
    // 再通过 listModel.getElementAt(int index) 和 listModel.getSize() 
    // 可分别 获取指定索引的选项数据 和 选项数量。
    ListModel<?> getModel()

JList 选项选中索引 相关方法：

// 设置选择模式，有三个模式: 只能单选、可间隔多选、可连续多选
    void setSelectionMode(int selectionMode)
    
    // 设置某个选项选中
    void setSelectedIndex(int index)
    
    // 设置某一些选项选中
    void setSelectedIndices(int[] indices)
    
    // 获取第一个选中的选项索引
    int getSelectedIndex()
    
    // 获取所有选中的选项索引
    int[] getSelectedIndices()

JList 字体和颜色 相关方法：

// 设置字体
    void setFont(Font font)
    
    // 设置字体颜色（未选中时）
    void setForeground(Color fg)
    
    // 设置选中选项的字体颜色
    void setSelectionForeground(Color selectionForeground)
    
    // 设置选中条的颜色
    void setSelectionBackground(Color selectionBackground)

JList 监听器 相关方法：

// 添加选项选中状态被改变的监听器
    void addListSelectionListener(ListSelectionListener listener)

## 2.代码实例 ##

import com.lijinjiang.beautyeye.BeautyEyeLNFHelper;
    import javax.swing.*;
    import javax.swing.event.ListSelectionEvent;
    import javax.swing.event.ListSelectionListener;
    import java.awt.*;
    
    public class Demo01 {
        
        public static void main(String[] args) {
        
            try {
        
                BeautyEyeLNFHelper.frameBorderStyle = BeautyEyeLNFHelper.FrameBorderStyle.generalNoTranslucencyShadow;
                BeautyEyeLNFHelper.launchBeautyEyeLNF();
            } catch (Exception e) {
        
                e.printStackTrace();
            }
            JFrame frame = new JFrame("Demo01");
            frame.setSize(300, 300);
    
            JPanel panel = new JPanel();
    
            // 创建一个 JList 实例
            final JList<String> list = new JList<String>();
    
            // 设置一下首选大小
            list.setPreferredSize(new Dimension(200, 100));
    
            // 允许可间断的多选
            list.setSelectionMode(ListSelectionModel.MULTIPLE_INTERVAL_SELECTION);
    
            // 设置选项数据（内部将自动封装成 ListModel ）
            list.setListData(new String[]{
        "苹果", "香蕉", "雪梨", "西瓜"});
    
            // 添加选项选中状态被改变的监听器
            list.addListSelectionListener(new ListSelectionListener() {
        
                @Override
                public void valueChanged(ListSelectionEvent e) {
        
                    // 获取所有被选中的选项索引
                    int[] indices = list.getSelectedIndices();
                    // 获取选项数据的 ListModel
                    ListModel<String> listModel = list.getModel();
                    // 输出选中的选项
                    for (int index : indices) {
        
                        System.out.println("选中: " + index + " = " + listModel.getElementAt(index));
                    }
                    System.out.println();
                }
            });
    
            // 设置默认选中项
            list.setSelectedIndex(0);
    
            // 添加到内容面板容器
            panel.add(list);
    
            frame.add(panel);
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setLocationRelativeTo(null);
            frame.setVisible(true);
        }
    }

## 3.效果展示 ##

按住 Ctrl 键可以多选，按住 Shift 键可以连续选择  
![在这里插入图片描述][7e28e5b648d045dabdb367674facb1bb.png]

[https_gitee.com_lijinjiang01_JavaSwing]: https://gitee.com/lijinjiang01/JavaSwing
[7e28e5b648d045dabdb367674facb1bb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/b012794b61f148c18bcfd7431fcf142d.png