如何让JComboBox每次选项变更（含重复点击）时刷新显示文本？

问题背景 #

自定义ListCellRenderer区分了JComboBox的顶部显示文本和下拉选项文本，但每次点击选项（尤其是重复点击已选中选项）时，渲染器不会触发，导致顶部文本无法刷新。且自定义JComboBox修改了下拉弹窗点击后不自动隐藏的逻辑，进一步影响了默认的UI更新机制。

核心原因 #

• 默认JComboBox仅在选中项实际变更时才触发渲染器更新，重复点击已选选项不会触发状态变更事件。
• 弹窗不隐藏时，JComboBox的默认UI刷新逻辑不会主动调用渲染器重新绘制顶部显示区域。

解决方案 #

1. 给下拉列表添加鼠标监听器，捕获点击事件强制刷新

通过获取JComboBox的下拉列表组件，添加MouseListener，每次点击选项（无论是否已选中）都触发显示文本的刷新：

public class CustomComboBox extends JComboBox<Object> {
    public CustomComboBox() {
        // 保留你修改的弹窗不隐藏逻辑
        setUI(new BasicComboBoxUI() {
            @Override
            protected void setPopupVisible(JComboBox<?> c, boolean v) {
                // 仅在主动隐藏时执行默认逻辑，实现点击后弹窗不隐藏
                if (!v) {
                    super.setPopupVisible(c, v);
                }
            }
        });

        // 获取下拉列表并绑定鼠标点击监听
        addPopupMenuListener(new PopupMenuListener() {
            @Override
            public void popupMenuWillBecomeVisible(PopupMenuEvent e) {
                JList<?> list = (JList<?>) ((JComboBox<?>)e.getSource()).getUI().getAccessibleChild((JComboBox<?>)e.getSource(), 0);
                if (list != null) {
                    list.addMouseListener(new MouseAdapter() {
                        @Override
                        public void mousePressed(MouseEvent e) {
                            int index = list.locationToIndex(e.getPoint());
                            if (index != -1) {
                                Object targetItem = getItemAt(index);
                                // 强制触发显示更新，无论选项是否已选中
                                forceDisplayUpdate(targetItem);
                            }
                        }
                    });
                }
            }

            @Override
            public void popupMenuWillBecomeInvisible(PopupMenuEvent e) {}
            @Override
            public void popupMenuCanceled(PopupMenuEvent e) {}
        });

        // 设置自定义渲染器
        setRenderer(new ListCellRenderer<Object>() {
            @Override
            public Component getListCellRendererComponent(JList<?> list, Object value, int index, boolean isSelected, boolean cellHasFocus) {
                if (index == -1) {
                    return new JLabel("this is the top cell");
                }
                return new JLabel("this is a cell in the dropdown popup area");
            }
        });
    }

    private void forceDisplayUpdate(Object item) {
        Object oldItem = getSelectedItem();
        // 触发选中项属性变更事件，强制渲染器重新执行
        firePropertyChange("selectedItem", oldItem, item);
        // 强制重绘顶部显示区域
        repaint();
    }
}

2. 重写setSelectedItem方法确保代码触发时也能刷新

如果需要通过代码调用选中逻辑时也触发更新，重写setSelectedItem方法，无论新旧值是否相同都强制更新：

@Override
public void setSelectedItem(Object anObject) {
    Object oldValue = getSelectedItem();
    super.setSelectedItem(anObject);
    // 强制触发属性变更和组件重绘
    firePropertyChange("selectedItem", oldValue, anObject);
    repaint();
}

关键说明 #

• firePropertyChange("selectedItem", oldValue, item)会触发JComboBox的UI更新逻辑，调用渲染器重新绘制顶部显示区域。
• repaint()确保组件立即重绘，避免UI延迟更新。
• 鼠标监听器捕获下拉列表的点击事件，覆盖了重复点击已选选项的场景，解决了默认逻辑不触发更新的问题。

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