如何让Swing组件跨多层继承弹出菜单？

• 三层嵌套Swing组件结构，仅最上层组件配置了弹出菜单，其余层级未设置。
• 最底层组件添加了MouseWheelListener（普通MouseListener也会触发相同问题），导致右键点击事件被该组件拦截，上层的弹出菜单无法正常触发。
• 原生inheritsPopupMenu属性仅支持向上查找一层父组件的弹出菜单，若组件层级较多，需要手动给每一层组件设置该属性，实际生产环境中这种方案扩展性差。
• 预期行为：从右键点击的组件开始，向上逐层遍历父组件，找到第一个拥有弹出菜单的组件后，触发其弹出菜单。

最小可复现代码 #

package demos.popup;

import javax.swing.JComponent;
import javax.swing.JFrame;
import javax.swing.JMenuItem;
import javax.swing.JPanel;
import javax.swing.JPopupMenu;
import javax.swing.WindowConstants;
import java.awt.BorderLayout;
import java.awt.Container;
import java.awt.Dimension;

/**
 * The popup is broken. Uncomment the commented out lines to make it work
 */
public class PopupDemo {

    public static void main(String[] args) {
        Container mainPanel = createMainPanel();
        JFrame frame = new JFrame("Popup Demo");
        frame.setContentPane(mainPanel);
        frame.setLocationRelativeTo(null);
        frame.pack();
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
        frame.setVisible(true);
    }

    private static JComponent createMainPanel() {
        JComponent mainComp = createPanelWithPopup();
        return mainComp;
    }

    private static JPanel createPanelWithPopup() {
        JPanel panel = new JPanel(new BorderLayout()) {
            @Override
            public String toString() {
                return "Popup Panel";
            }

        };
        panel.setComponentPopupMenu(createPopupMenu());
        panel.add(createChild());
        panel.setPreferredSize(new Dimension(250,150));
        return panel;
    }

    private static JComponent createChild() {
        JPanel panel = new JPanel(new BorderLayout()) {
            @Override
            public String toString() {
                return "Child Panel";
            }
        };
        //panel.setInheritsPopupMenu(true);
        panel.add(createGrandchild());
        return panel;
    }

    private static JComponent createGrandchild() {
        JPanel panel = new JPanel(new BorderLayout()) {
            @Override
            public String toString() {
                return "Grandchild Panel";
            }
        };
        //panel.setInheritsPopupMenu(true);
        panel.addMouseWheelListener(e -> {});
        return panel;
    }

    private static JPopupMenu createPopupMenu() {
        JPopupMenu popupMenu = new JPopupMenu();
        popupMenu.add(createTestMenuItem());
        return popupMenu;
    }

    private static JMenuItem createTestMenuItem() {
        JMenuItem menuItem = new JMenuItem("Test menu item");
        menuItem.addActionListener(e -> System.out.println("Test menu item triggered..."));
        return menuItem;
    }
}

方案1：递归查找父组件弹出菜单并手动触发 #

给底层组件添加右键事件监听，在事件触发时递归向上查找拥有弹出菜单的父组件，找到后显示该菜单。

修改createGrandchild方法，并添加递归查找方法：

import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;

private static JComponent createGrandchild() {
    JPanel panel = new JPanel(new BorderLayout()) {
        @Override
        public String toString() {
            return "Grandchild Panel";
        }
    };
    panel.addMouseWheelListener(e -> {});
    
    // 添加右键事件处理
    panel.addMouseListener(new MouseAdapter() {
        @Override
        public void mouseReleased(MouseEvent e) {
            if (e.isPopupTrigger()) {
                JComponent targetComp = findComponentWithPopup(panel);
                if (targetComp != null) {
                    JPopupMenu popup = targetComp.getComponentPopupMenu();
                    popup.show(e.getComponent(), e.getX(), e.getY());
                }
            }
        }
    });
    return panel;
}

// 递归查找拥有弹出菜单的父组件
private static JComponent findComponentWithPopup(JComponent comp) {
    if (comp.getComponentPopupMenu() != null) {
        return comp;
    }
    Container parent = comp.getParent();
    if (parent instanceof JComponent) {
        return findComponentWithPopup((JComponent) parent);
    }
    return null;
}

方案2：自定义组件自动继承弹出菜单 #

创建自定义JPanel子类，重写getComponentPopupMenu方法，自动向上遍历父组件查找弹出菜单。所有使用该自定义组件的层级都能自动继承上层菜单，无需手动设置inheritsPopupMenu。

import java.awt.LayoutManager;
import javax.swing.JPanel;
import javax.swing.JPopupMenu;
import java.awt.Container;

public class InheritingPopupPanel extends JPanel {
    public InheritingPopupPanel(LayoutManager layout) {
        super(layout);
    }

    @Override
    public JPopupMenu getComponentPopupMenu() {
        JPopupMenu popup = super.getComponentPopupMenu();
        if (popup == null) {
            Container parent = getParent();
            if (parent instanceof JPanel) {
                popup = ((JPanel) parent).getComponentPopupMenu();
            }
        }
        return popup;
    }
}

修改示例中的组件创建方法，替换为自定义面板：

private static JComponent createChild() {
    JPanel panel = new InheritingPopupPanel(new BorderLayout()) {
        @Override
        public String toString() {
            return "Child Panel";
        }
    };
    panel.add(createGrandchild());
    return panel;
}

private static JComponent createGrandchild() {
    JPanel panel = new InheritingPopupPanel(new BorderLayout()) {
        @Override
        public String toString() {
            return "Grandchild Panel";
        }
    };
    panel.addMouseWheelListener(e -> {});
    return panel;
}

方案3：全局事件监听统一处理 #

注册全局AWT事件监听器，拦截所有鼠标右键事件，自动查找目标组件及其父组件的弹出菜单并显示。该方案无需修改现有组件，适合已有大量组件的项目。

import java.awt.AWTEvent;
import java.awt.Toolkit;
import java.awt.event.AWTEventListener;
import java.awt.event.MouseEvent;

public class PopupDemo {

    public static void main(String[] args) {
        // 注册全局事件监听
        Toolkit.getDefaultToolkit().addAWTEventListener(event -> {
            if (event instanceof MouseEvent) {
                MouseEvent e = (MouseEvent) event;
                if (e.isPopupTrigger() && e.getComponent() instanceof JComponent) {
                    JComponent targetComp = findComponentWithPopup((JComponent) e.getComponent());
                    if (targetComp != null) {
                        JPopupMenu popup = targetComp.getComponentPopupMenu();
                        popup.show(e.getComponent(), e.getX(), e.getY());
                        e.consume(); // 阻止事件被其他组件拦截
                    }
                }
            }
        }, AWTEvent.MOUSE_EVENT_MASK);

        Container mainPanel = createMainPanel();
        JFrame frame = new JFrame("Popup Demo");
        frame.setContentPane(mainPanel);
        frame.setLocationRelativeTo(null);
        frame.pack();
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
        frame.setVisible(true);
    }

    // 复用递归查找方法
    private static JComponent findComponentWithPopup(JComponent comp) {
        if (comp.getComponentPopupMenu() != null) {
            return comp;
        }
        Container parent = comp.getParent();
        if (parent instanceof JComponent) {
            return findComponentWithPopup((JComponent) parent);
        }
        return null;
    }

    // 其余方法保持不变...
}

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