JPanel子类PointPanel按Shift键切换鼠标光标失效问题排查

你的代码无法生效的核心原因是：JPanel默认不具备焦点能力（focusable属性为false），即使所在窗口是激活状态，组件本身没有获得键盘焦点时，KeyListener无法接收到键盘事件。而且即便你设置了focusable=true，也需要用户点击面板让它获得焦点才能触发监听，这显然不符合「鼠标悬停时就响应Shift键」的需求。

下面是两种可靠的解决方案：

方案一：使用Swing Key Bindings（推荐） #

Key Bindings是Swing官方推荐的键盘事件处理方式，它可以在组件未获得焦点的情况下，只要所在窗口处于激活状态就响应键盘事件。结合鼠标监听判断鼠标是否悬停，就能完美实现需求：

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

public class PointPanel extends JPanel {
    private boolean mouseOver = false;

    public PointPanel() {
        // 监听鼠标进入/离开，记录悬停状态
        addMouseListener(new MouseAdapter() {
            @Override
            public void mouseEntered(MouseEvent e) {
                mouseOver = true;
            }

            @Override
            public void mouseExited(MouseEvent e) {
                mouseOver = false;
                // 鼠标离开时强制恢复默认光标
                setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR));
            }
        });

        // 处理Shift按下的逻辑
        Action shiftPressed = new AbstractAction() {
            @Override
            public void actionPerformed(ActionEvent e) {
                if (mouseOver) {
                    setCursor(Cursor.getPredefinedCursor(Cursor.HAND_CURSOR));
                }
            }
        };

        // 处理Shift释放的逻辑
        Action shiftReleased = new AbstractAction() {
            @Override
            public void actionPerformed(ActionEvent e) {
                if (mouseOver) {
                    setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR));
                }
            }
        };

        // 绑定键盘事件到窗口激活状态（无需组件获得焦点）
        InputMap inputMap = getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
        ActionMap actionMap = getActionMap();

        // 绑定Shift按下事件（第三个参数false表示按下时触发）
        inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_SHIFT, 0, false), "shiftPressed");
        actionMap.put("shiftPressed", shiftPressed);

        // 绑定Shift释放事件（第三个参数true表示释放时触发）
        inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_SHIFT, 0, true), "shiftReleased");
        actionMap.put("shiftReleased", shiftReleased);
    }
}

方案二：使用全局AWT键盘监听 #

通过注册全局的AWTEventListener，可以监听整个应用的键盘事件，再结合鼠标位置判断是否在面板范围内：

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

public class PointPanel extends JPanel {
    public PointPanel() {
        // 注册全局键盘监听
        Toolkit.getDefaultToolkit().addAWTEventListener(event -> {
            if (event instanceof KeyEvent keyEvent) {
                // 判断鼠标是否在当前面板内
                Point mousePos = MouseInfo.getPointerInfo().getLocation();
                SwingUtilities.convertPointFromScreen(mousePos, this);
                boolean isMouseOver = contains(mousePos);

                if (keyEvent.getID() == KeyEvent.KEY_PRESSED) {
                    if (keyEvent.getKeyCode() == KeyEvent.VK_SHIFT && isMouseOver) {
                        setCursor(Cursor.getPredefinedCursor(Cursor.HAND_CURSOR));
                    }
                } else if (keyEvent.getID() == KeyEvent.KEY_RELEASED) {
                    if (keyEvent.getKeyCode() == KeyEvent.VK_SHIFT) {
                        setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR));
                    }
                }
            }
        }, AWTEvent.KEY_EVENT_MASK);
    }
}

关于KeyListener的补充说明 #

如果你坚持要使用KeyListener，需要做以下修改，但这种方式局限性很大（比如面板失去焦点后就失效）：

1. 在构造方法中添加setFocusable(true);，让面板可以获得焦点
2. 在鼠标进入事件中调用requestFocusInWindow();，让面板自动获得焦点：

addMouseListener(new MouseAdapter() {
    @Override
    public void mouseEntered(MouseEvent e) {
        requestFocusInWindow();
    }
});

但这种方式不如Key Bindings稳定，不推荐使用。

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