核心概念

1. JCheckBox 类: Swing 中用于创建复选框组件的类。
2. isSelected() 方法: 这是 JAbstractButton（JCheckBox 的父类）提供的关键方法，它返回一个 boolean 值：
   • true: 复选框被选中。
   • false: 复选框未被选中。
3. ItemListener 接口: 这是处理复选框状态变化事件的标准方式，当复选框的“选中”或“未选中”状态发生改变时，会触发 ItemEvent。
4. ActionListener 接口: 也可以使用 ActionListener，它会在复选框被点击（无论状态如何改变）时触发一次。

获取单个复选框的选中状态

这是最基本的需求,比如在点击一个“提交”按钮时，检查某个复选框是否被勾选。

示例代码

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
public class SingleCheckBoxExample {
    public static void main(String[] args) {
        // 1. 创建窗口
        JFrame frame = new JFrame("单个复选框示例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(300, 150);
        frame.setLayout(new FlowLayout());
        // 2. 创建复选框和按钮
        JCheckBox agreeCheckBox = new JCheckBox("我同意服务条款");
        JButton submitButton = new JButton("提交");
        // 3. 创建标签用于显示结果
        JLabel resultLabel = new JLabel("请先同意条款");
        resultLabel.setForeground(Color.RED);
        // 4. 为按钮添加点击事件监听器
        submitButton.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 使用 isSelected() 方法获取复选框的选中状态
                if (agreeCheckBox.isSelected()) {
                    resultLabel.setText("感谢您的同意！");
                    resultLabel.setForeground(Color.GREEN);
                } else {
                    resultLabel.setText("请先同意条款");
                    resultLabel.setForeground(Color.RED);
                }
            }
        });
        // 5. 将组件添加到窗口
        frame.add(agreeCheckBox);
        frame.add(submitButton);
        frame.add(resultLabel);
        // 6. 显示窗口
        frame.setVisible(true);
    }
}

代码解析:

• 我们创建了一个 JCheckBox 和一个 JButton。
• 为 JButton 添加了 ActionListener。
• 在 actionPerformed 方法中，我们调用 agreeCheckBox.isSelected() 来判断复选框是否被选中，并根据结果显示不同的信息。

监听单个复选框的状态变化

如果你希望在用户点击复选框的瞬间就做出反应（实时显示状态），而不是等到点击另一个按钮，那么应该使用 ItemListener。

示例代码

import javax.swing.*;
import java.awt.*;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;
public class CheckBoxItemListenerExample {
    public static void main(String[] args) {
        // 1. 创建窗口
        JFrame frame = new JFrame("ItemListener 示例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(300, 150);
        frame.setLayout(new FlowLayout());
        // 2. 创建复选框和状态标签
        JCheckBox checkBox = new JCheckBox("启用高级模式");
        JLabel statusLabel = new JLabel("当前状态：未启用");
        // 3. 为复选框添加 ItemListener
        checkBox.addItemListener(new ItemListener() {
            @Override
            public void itemStateChanged(ItemEvent e) {
                // e.getStateChange() 可以获取到新的状态
                // ItemEvent.SELECTED 表示选中
                // ItemEvent.DESELECTED 表示未选中
                if (e.getStateChange() == ItemEvent.SELECTED) {
                    statusLabel.setText("当前状态：已启用");
                } else {
                    statusLabel.setText("当前状态：未启用");
                }
            }
        });
        // 4. 将组件添加到窗口
        frame.add(checkBox);
        frame.add(statusLabel);
        // 5. 显示窗口
        frame.setVisible(true);
    }
}

代码解析:

• 我们为 JCheckBox 添加了 ItemListener。
• itemStateChanged 方法会在复选框状态改变时被调用。
• ItemEvent e 参数包含了事件的所有信息，e.getStateChange() 可以告诉你状态是变为 SELECTED 还是 DESELECTED。

处理多个复选框

当你有多个复选框时,通常有两种处理方式：

1. 为每个复选框单独添加监听器（适用于逻辑独立的情况）。
2. 使用一个共享的监听器,通过事件源来判断是哪个复选框触发了事件（更推荐，代码更简洁）。

示例代码（共享监听器）

import javax.swing.*;
import java.awt.*;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;
public class MultipleCheckBoxesExample {
    public static void main(String[] args) {
        // 1. 创建窗口
        JFrame frame = new JFrame("多个复选框示例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(350, 200);
        frame.setLayout(new FlowLayout());
        // 2. 创建多个复选框
        JCheckBox fruit1 = new JCheckBox("苹果");
        JCheckBox fruit2 = new JCheckBox("香蕉");
        JCheckBox fruit3 = new JCheckBox("橙子");
        // 3. 创建一个文本区域来显示选中的项
        JTextArea selectedItemsArea = new JTextArea(5, 20);
        selectedItemsArea.setEditable(false);
        // 4. 创建一个共享的 ItemListener
        ItemListener listener = new ItemListener() {
            @Override
            public void itemStateChanged(ItemEvent e) {
                // 清空文本区域，然后重新构建所有选中的项
                selectedItemsArea.setText("您选择了：\n");
                if (fruit1.isSelected()) {
                    selectedItemsArea.append("- 苹果\n");
                }
                if (fruit2.isSelected()) {
                    selectedItemsArea.append("- 香蕉\n");
                }
                if (fruit3.isSelected()) {
                    selectedItemsArea.append("- 橙子\n");
                }
                // 如果一个都没选，可以显示提示信息
                if (!fruit1.isSelected() && !fruit2.isSelected() && !fruit3.isSelected()) {
                    selectedItemsArea.setText("请选择您喜欢的水果。");
                }
            }
        };
        // 5. 为所有复选框添加同一个监听器
        fruit1.addItemListener(listener);
        fruit2.addItemListener(listener);
        fruit3.addItemListener(listener);
        // 6. 将组件添加到窗口
        frame.add(new JLabel("选择你喜欢的水果:"));
        frame.add(fruit1);
        frame.add(fruit2);
        frame.add(fruit3);
        frame.add(new JScrollPane(selectedItemsArea)); // 用JScrollPane包裹以便内容过多时可以滚动
        // 7. 显示窗口
        frame.setVisible(true);
    }
}

代码解析:

• 我们创建了三个 JCheckBox 实例。
• 创建了一个 ItemListener 对象，并在其 itemStateChanged 方法中，通过分别检查每个复选框的 isSelected() 状态来更新 JTextArea 的内容。
• 将这个同一个监听器对象添加到了所有的复选框上，当任何一个复选框的状态改变时，都会触发这个监听器，从而更新显示。

总结与最佳实践

最佳实践建议:

1. 当需要查询状态时：使用 isSelected()，在“保存”或“提交”按钮的回调函数中检查条件。
2. 当需要对状态变化做出即时响应时：使用 ItemListener，复选框控制某个面板的启用/禁用，或实时更新显示内容。
3. 处理多个复选框：尽量使用一个共享的 ItemListener 或 ActionListener，通过 event.getSource() 来判断事件源，这样可以避免为每个控件创建独立的监听器，使代码更易于维护。