如何在Swing中可靠监听鼠标移动及鼠标下方组件的移动？

首先得说，你这个思路方向完全正确——监听组件和祖先的移动事件确实是核心，但不用头疼“监听所有相关变化”，我们可以动态跟踪当前鼠标下方的组件，只给它和它的祖先加监听器，这样就不用全局监听所有组件啦！

下面给你一套具体的实现思路和代码示例：

核心逻辑拆解 #

1. 跟踪当前鼠标下的组件：每次鼠标移动时，用SwingUtilities.getDeepestComponentAt(container, x, y)获取鼠标位置最底层的组件，记录下来作为当前“目标组件”。
2. 为目标组件及其祖先添加移动监听器：
   • 给目标组件加ComponentListener，监听它自身的移动；
   • 给目标组件的所有祖先加AncestorListener，监听祖先的移动（因为祖先动了，子组件的屏幕位置也会跟着变）；
3. 处理监听器的触发：当组件或祖先移动时，先检查当前鼠标是否还在这个组件范围内（避免组件移开但鼠标没动的误触发），如果是的话，就触发你的自定义通知；
4. 清理旧监听器：当鼠标移到新组件时，要移除之前给旧组件和祖先加的监听器，防止内存泄漏和重复触发。

代码示例 #

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;
import java.util.ArrayList;
import java.util.List;

public class HoverComponentMoveTracker {
    private Component currentHoveredComponent;
    private final List<ComponentListener> componentListeners = new ArrayList<>();
    private final List<AncestorListener> ancestorListeners = new ArrayList<>();
    private final JComponent container;

    public HoverComponentMoveTracker(JComponent container) {
        this.container = container;
        // 先添加鼠标移动监听
        container.addMouseMotionListener(new MouseMotionAdapter() {
            @Override
            public void mouseMoved(MouseEvent e) {
                updateHoveredComponent(e.getPoint());
            }
        });
    }

    private void updateHoveredComponent(Point mousePoint) {
        // 获取当前鼠标下的最底层组件
        Component newComponent = SwingUtilities.getDeepestComponentAt(container, mousePoint.x, mousePoint.y);
        
        if (newComponent != currentHoveredComponent) {
            // 移除旧组件的监听器
            removeOldListeners();
            // 更新当前组件
            currentHoveredComponent = newComponent;
            // 给新组件和祖先加监听器
            if (currentHoveredComponent != null) {
                addComponentMoveListeners(currentHoveredComponent);
            }
        }
    }

    private void addComponentMoveListeners(Component component) {
        // 给组件自身加ComponentListener
        ComponentListener cl = new ComponentAdapter() {
            @Override
            public void componentMoved(ComponentEvent e) {
                onHoveredComponentMoved();
            }
        };
        component.addComponentListener(cl);
        componentListeners.add(cl);

        // 给所有祖先加AncestorListener
        Component ancestor = component.getParent();
        while (ancestor != null && ancestor != container) {
            AncestorListener al = new AncestorAdapter() {
                @Override
                public void ancestorMoved(AncestorEvent event) {
                    onHoveredComponentMoved();
                }
            };
            ((JComponent) ancestor).addAncestorListener(al);
            ancestorListeners.add(al);
            ancestor = ancestor.getParent();
        }
    }

    private void removeOldListeners() {
        if (currentHoveredComponent != null) {
            for (ComponentListener cl : componentListeners) {
                currentHoveredComponent.removeComponentListener(cl);
            }
            // 移除祖先的监听器
            Component ancestor = currentHoveredComponent.getParent();
            int index = 0;
            while (ancestor != null && ancestor != container) {
                ((JComponent) ancestor).removeAncestorListener(ancestorListeners.get(index));
                index++;
                ancestor = ancestor.getParent();
            }
        }
        componentListeners.clear();
        ancestorListeners.clear();
    }

    // 这里是你自定义的通知逻辑，比如触发回调或者事件
    private void onHoveredComponentMoved() {
        if (currentHoveredComponent == null) return;
        // 先检查鼠标是否还在组件范围内
        Point mousePos = MouseInfo.getPointerInfo().getLocation();
        SwingUtilities.convertPointFromScreen(mousePos, container);
        Component underMouse = SwingUtilities.getDeepestComponentAt(container, mousePos.x, mousePos.y);
        if (SwingUtilities.isDescendingFrom(underMouse, currentHoveredComponent)) {
            System.out.println("鼠标下方的组件/祖先移动了！当前组件：" + currentHoveredComponent.getClass().getName());
            // 这里替换成你的业务逻辑
        }
    }

    // 测试用例
    public static void main(String[] args) {
        JFrame frame = new JFrame("Hover Component Move Tracker");
        JPanel panel = new JPanel(null);
        panel.setPreferredSize(new Dimension(500, 500));

        JButton button = new JButton("可移动按钮");
        button.setBounds(100, 100, 150, 50);
        panel.add(button);

        // 模拟按钮移动
        new Timer(2000, e -> {
            button.setLocation(button.getX() + 50, button.getY() + 50);
        }).start();

        new HoverComponentMoveTracker(panel);

        frame.add(panel);
        frame.pack();
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setVisible(true);
    }
}

额外注意点 #

• 如果你的组件有层级变化（比如被添加/移除到容器，或者显示/隐藏），可以再加个HierarchyListener监听hierarchyChanged事件，在层级变化时重新检查当前鼠标下的组件；
• 代码里的onHoveredComponentMoved方法做了二次检查，确保组件移动时鼠标确实还在它上方，避免组件移走后误触发；
• 记得在容器销毁时调用removeOldListeners，彻底清理监听器。

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