Java Swing GUI编程：JList列表与JComboBox组合框的使用详解

沿途有光

发布时间：2026-10-13 | 6人浏览过

原创

掌握Java Swing中列表(JList)和组合框(JComboBox)的设计与交互。本文详细解析如何配置单选/多选模式、添加滚动支持、处理用户选择与输入事件，并提供完整的可运行代码示例。

JList 列表组件的设计与交互

列表(JList)在Java Swing界面上表现为一个包含多个选项的列表框。程序可以在此列表框中加入多个文本条目供用户选择。JList的核心功能在于数据的展示与用户的选择反馈，主要涉及构造方法的初始化、选择模型的设定以及事件监听器的注册。

第1步：创建与初始化列表对象

JList通常通过构造函数进行初始化，最常见的方式是传入字符串数组作为初始数据源。

JList()：创建一个空的列表。
JList(String list[])：利用字符串数组初始化列表，数组元素即为列表项。

// 示例：创建包含新闻名称的列表
String news[] = {"人民日报", "新民晚报", "浙江日报", "文汇报"};
JList list1 = new JList(news); // 此处仅示意声明，实际需放入Container

第2步：设置选择模式与可见行数

为了满足不同场景的需求，可以通过setSelectionMode方法设定单选或多选，并使用setVisibleRowCount控制显示的行数，超出部分可通过滚动条查看。

单选模式：ListSelectionModel.SINGLE_SELECTION
多选模式：ListSelectionModel.MULTIPLE_INTERVAL_SELECTION

list1.setVisibleRowCount(3); // 固定显示3行
list1.setSelectionMode(ListSelectionModel.SINGLE_SELECTION); // 设为单选

若希望列表具备滚动功能，需将JList包装在JScrollPane中：

JScrollPane jsp = new JScrollPane(list2);

第3步：实现选择事件监听

列表的事件监听主要关注两种操作：鼠标单击（选项变更）和鼠标双击（动作触发）。

单击选项：属于选项事件，实现ListSelectionListener接口，重写valueChanged方法。通过addListSelectionListener注册。
双击选项：属于动作事件，实现ActionListener接口，重写actionPerformed方法。通过addActionListener注册。

常用数据获取方法包括getSelectedIndex()获取选中项索引，getSelectedValue()获取具体值。在多选中，可使用getSelectedIndices()或getSelectedValues()获取所有选中项。

JList 综合应用示例：单选与多选列表

以下示例展示了一个继承自JFrame的类，包含两个JList实例：第一个仅允许单选新闻，第二个允许多选体育项目。程序实时在TextArea中显示当前选中的内容。

import java.applet.*;
import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

class MyWindow extends JFrame implements ListSelectionListener{
  JList list1,list2;
  String news[]={"人民日报","新民晚报","浙江日报","文汇报"};
  String sports[]={"足球","排球","乒乓球","篮球"};
  JTextArea text;
  
  MyWindow(String s){
    super(s);
    Container con = getContentPane();
    con.setBackground(Color.BLUE);
    con.setLayout(new GridLayout(2,2));
    con.setSize(200,500);
    
    // 初始化列表1：单选
    list1 = new JList(news);
    list1.setVisibleRowCount(3);
    list1.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
    list1.addListSelectionListener(this);
    
    // 初始化列表2：多选
    list2 = new JList(sports);
    list2.setVisibleRowCount(2);
    list2.setSelectionMode(ListSelectionModel.MULTIPLE_INTERVAL_SELECTION);
    list2.addListSelectionListener(this);
    
    con.add(list1);
    con.add(list2);
    text= new JTextArea(10,20);
    con.add(text);
    
    this.pack();
    this.setVisible(true);
  }
  
  public void valueChanged(ListSelectionEvent e){
    if(e.getSource()==list1){
      text.setText(null);
      Object listValue = ((JList) e.getSource()).getSelectedValue();
      String seleName = (listValue != null) ? listValue.toString() : "";
      // 简单匹配输出
      for(int i=0;i<news.length;i++)
        if(news[i].equals(seleName)){
          text.append(seleName + "被选中\n");
        }
    } else if(e.getSource()==list2){
      text.setText(null);
      int tempList[] = list2.getSelectedIndices();
      for(int i=0;i<tempList.length;i++)
        text.append(sports[tempList[i]] + "被选中\n");
   }
 }
}
public class Example6_3 extends Applet{
  MyWindow myWin = new MyWindow("列表示例");
}

JComboBox 组合框的设计与交互

组合框(JComboBox)结合了文本框与下拉列表的功能。用户既可以从下拉菜单中选择已有选项，也可以在设置为可编辑(setEditable(true))的情况下直接输入新内容。

第1步：创建组合框并添加选项

组合框的构造方式灵活，可直接传入数组或使用默认模型。动态管理选项可使用addItem()、removeItem()等方法。

String proList[] = { "踢足球", "打篮球", "打排球" };
JComboBox comboBox = new JComboBox(proList);
// 可选：设为可编辑以支持键盘输入
comboBox.setEditable(true);

第2步：处理选择与输入事件

组合框涉及两类主要事件，需分别实现对应的监听器接口：

选定项目：当用户从下拉列表中点击某一项时触发。需实现ItemListener接口，处理itemStateChanged方法。此时可通过getSelectedItem()获取选定内容。
输入回车：当用户在组合框文本区输入内容并按下回车键时触发。需实现ActionListener接口，处理actionPerformed方法。

JComboBox 综合应用示例

以下示例演示了如何处理JComboBox的选择与输入双重事件。程序启动后显示一个包含三项运动的组合框和一个文本框。无论用户下拉选择还是手动输入后按回车，结果都会同步显示在文本框中。

public class Example6_4 {
  public static void main(String args[]) {
    ComboBoxDemo mycomboBoxGUI = new ComboBoxDemo();
  }
}

class ComboBoxDemo extends JFrame implements ActionListener, ItemListener {
  public static final int Width = 350;
  public static final int Height = 150;
  String proList[] = { "踢足球", "打篮球", "打排球" };
  JTextField text;
  JComboBox comboBox;
  
  public ComboBoxDemo() {
    setSize(Width, Height);
    setTitle("组合框使用示意程序");
    Container conPane = getContentPane();
    conPane.setBackground(Color.BLUE);
    conPane.setLayout(new FlowLayout());
    
    comboBox = new JComboBox(proList);
    // 注册两种监听器
    comboBox.addActionListener(this);
    comboBox.addItemListener(this);
    comboBox.setEditable(true); // 启用编辑功能
    
    conPane.add(comboBox);
    text = new JTextField(10);
    conPane.add(text);
    
    this.setVisible(true);
  }
  
  // 处理按下回车键事件
  public void actionPerformed(ActionEvent e) {
    if (e.getSource() == comboBox) {
      text.setText(comboBox.getSelectedItem().toString());
    }
  }
  
  // 处理下拉选择变更事件
  public void itemStateChanged(ItemEvent e) {
    if (e.getSource() == comboBox) {
      text.setText(comboBox.getSelectedItem().toString());
    }
  }
}

以上就是关于Java Swing中JList列表和JComboBox组合框的详细设计使用指南。通过合理配置选择模式、滚动机制及事件监听器，开发者可以轻松构建交互式强、用户体验良好的图形用户界面。更多关于Java GUI控件的资料请关注本站其它相关文章！