如何捕获DefaultListModel中JList内按钮的点击事件并自定义按钮宽度

一、捕获按钮自身的点击事件 #

当前列表的鼠标监听器会拦截所有点击事件，导致按钮的ActionListener无法触发。需要做两处修改：

1. 给目标按钮添加ActionListener，定义点击后的逻辑；
2. 在列表的鼠标监听器中判断点击的组件是否为按钮，若是则跳过列表的点击处理逻辑。

二、缩小按钮宽度 #

直接设置按钮的preferredSize无效，因为列表单元格会强制拉伸组件占满宽度。解决方法是将按钮包裹在JPanel中，利用面板的布局管理器控制按钮的显示大小，避免被单元格拉伸。

修改后的完整代码 #

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;

public class JListTest {
    private JList list;
    private DefaultListModel dataModel;
    private JPanel panel = new JPanel();

    public JListTest() {
        dataModel = new DefaultListModel();
        list = new JList<>(dataModel);
        list.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent me) {
                // 判断点击的组件是否为按钮/含按钮的面板，若是则不执行列表点击逻辑
                Component component = list.getComponentAt(me.getPoint());
                if (component instanceof JButton 
                    || (component instanceof JPanel && ((JPanel) component).getComponentCount() > 0 
                    && ((JPanel) component).getComponent(0) instanceof JButton)) {
                    return;
                }
                SwingUtilities.invokeLater(() -> System.out.println("mouse event==" + me));
            }
        });
        list.setCellRenderer(new PanelRenderer());
    }

    public static void main(String[] args) {
        JListTest test = new JListTest();
        test.dataModel.addElement("Lable 1");
        // 创建带点击事件的按钮，并包裹在面板中控制宽度
        JButton captureBtn = createButton("Capture it's click !");
        captureBtn.addActionListener(e -> System.out.println("按钮自身点击事件触发！"));
        JPanel btnPanel = new JPanel(new FlowLayout(FlowLayout.LEFT)); // 可改为CENTER实现居中显示
        btnPanel.add(captureBtn);
        test.dataModel.addElement(btnPanel);
        test.dataModel.addElement("Lable 3");

        JButton button1 = new JButton("Button 1");
        JButton button2 = new JButton("Button 2");
        button1.addActionListener(e -> System.out.println(" button 1 click"));
        test.panel.add(button1);
        test.panel.add(button2);
        test.dataModel.addElement(test.panel);
        test.showUi();
    }

    public void showUi() {
        JFrame.setDefaultLookAndFeelDecorated(true);
        JFrame frame = new JFrame("Demo list");
        frame.setAlwaysOnTop(true);
        frame.setType(Window.Type.UTILITY);
        frame.setResizable(true);
        frame.getContentPane().setLayout(new BorderLayout());
        JScrollPane scrollPane = new JScrollPane(list);
        scrollPane.setPreferredSize(new Dimension(400, 250));
        frame.getContentPane().add(scrollPane, BorderLayout.NORTH);
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(500, 300);
        frame.setLocationRelativeTo(null);
        frame.setVisible(true);
    }

    class PanelRenderer implements ListCellRenderer {
        @Override
        public Component getListCellRendererComponent(JList list, Object value, int index, boolean isSelected, boolean cellHasFocus) {
            Component component;
            if (value instanceof String) {
                component = new DefaultListCellRenderer().getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
            } else {
                component = (Component) value;
            }
            // 统一设置选中/未选中的背景色
            component.setBackground(isSelected ? Color.GRAY : list.getBackground());
            // 原有按钮禁用逻辑，适配面板包裹的情况
            int listSize = list.getModel().getSize();
            if (listSize > 10 && index < listSize - 4) {
                if (value instanceof JPanel) {
                    for (Component comp : ((JPanel) value).getComponents()) {
                        if (comp instanceof JButton) {
                            ((JButton) comp).setEnabled(false);
                        }
                    }
                } else if (value instanceof JButton) {
                    ((JButton) value).setEnabled(false);
                }
            }
            return component;
        }
    }

    public static JButton createButton(String text) {
        JButton button = new JButton(text);
        // 设置按钮首选大小，控制宽度
        button.setPreferredSize(new Dimension(150, 40));
        return button;
    }
}

关键修改说明 #

1. 按钮点击事件处理：在列表的mouseClicked方法中，通过list.getComponentAt(me.getPoint())获取点击位置的组件，判断是否为按钮或包含按钮的面板，若是则直接返回，让按钮自身的ActionListener触发。
2. 按钮宽度控制：将按钮放入JPanel并使用FlowLayout布局，按钮会保持设置的preferredSize，不会被单元格拉伸占满宽度，还可通过布局的对齐方式调整按钮在单元格中的位置。
3. 选中状态统一：统一设置渲染组件的背景色，避免按钮选中时样式与列表项不一致。

内容的提问来源于stack exchange，提问作者amit ranjan