如何让JOptionPane初始时Enter键与空格键聚焦同一组件？

我通过JOptionPane.showInternalConfirmDialog创建的对话框包含OK/CANCEL按钮和一个复选框，遇到以下焦点问题：

• 首次打开窗口时，空格键可聚焦复选框，Enter键聚焦OK按钮，表现正常
• 按Tab切换焦点后，空格键和Enter键会聚焦到同一个组件，出现异常

创建对话框的代码如下：

JOptionPane.showInternalConfirmDialog(parent, messagePanel, title, JOptionPane.OK_CANCEL_OPTION,
                   JOptionPane.QUESTION_MESSAGE, messagePanel.getDetailsCheckbox());

问题根源 #

这是因为将复选框作为showInternalConfirmDialog的图标参数传入时，会打乱JOptionPane默认的组件焦点层次结构；Tab切换焦点后，默认的按键绑定逻辑出现冲突，导致空格键和Enter键指向同一组件。

修复方案 #

1. 调整组件传入方式（最简单）

不要将复选框作为图标参数传递，而是将其直接放在messagePanel内部，让JOptionPane按照正常的组件层次处理焦点：

// 确保messagePanel已经包含了detailsCheckbox，然后调用对话框
JOptionPane.showInternalConfirmDialog(parent, messagePanel, title, JOptionPane.OK_CANCEL_OPTION,
                   JOptionPane.QUESTION_MESSAGE);

2. 手动控制焦点与按键绑定

如果必须保留原有参数传入方式，可通过自定义焦点遍历策略和按键监听修复：

// 获取对话框实例（根据实际场景调整获取方式）
JInternalFrame dialog = (JInternalFrame) JOptionPane.getRootFrame().getGlassPane().getComponent(0);
RootPaneContainer rootPane = (RootPaneContainer) dialog.getContentPane().getParent();
JCheckBox detailsCheckbox = messagePanel.getDetailsCheckbox();
JButton okButton = (JButton) rootPane.getRootPane().getDefaultButton();
JButton cancelButton = (JButton) rootPane.getRootPane().getComponent(1);

// 设置自定义焦点遍历顺序
Component[] focusOrder = {detailsCheckbox, okButton, cancelButton};
rootPane.getRootPane().setFocusTraversalPolicy(new FocusTraversalPolicy() {
    @Override
    public Component getComponentAfter(Container aContainer, Component aComponent) {
        int idx = Arrays.asList(focusOrder).indexOf(aComponent);
        return focusOrder[(idx + 1) % focusOrder.length];
    }

    @Override
    public Component getComponentBefore(Container aContainer, Component aComponent) {
        int idx = Arrays.asList(focusOrder).indexOf(aComponent);
        return focusOrder[(idx - 1 + focusOrder.length) % focusOrder.length];
    }

    @Override
    public Component getFirstComponent(Container aContainer) {
        return focusOrder[0];
    }

    @Override
    public Component getLastComponent(Container aContainer) {
        return focusOrder[focusOrder.length - 1];
    }

    @Override
    public Component getDefaultComponent(Container aContainer) {
        return okButton;
    }
});

// 给复选框绑定独立的空格键响应，避免与按钮冲突
detailsCheckbox.addKeyListener(new KeyAdapter() {
    @Override
    public void keyPressed(KeyEvent e) {
        if (e.getKeyCode() == KeyEvent.VK_SPACE) {
            e.consume(); // 阻止事件传递给其他组件
            detailsCheckbox.doClick();
        }
    }
});

3. 自定义对话框（最彻底）

如果JOptionPane的默认逻辑限制过多，直接用JInternalFrame手动构建对话框，完全掌控组件布局、焦点顺序和按键响应，从根源避免冲突。

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