JTextField调用requestFocusInWindow()后偶现全选高亮问题求助

我有一个使用垂直BoxLayout布局的JPanel，里面包含多个JTextField。需求是编辑任意文本框时，将该文本框移至布局顶部（通过移除后重新添加到首位实现）。但执行此操作后文本框会失去焦点，因此我调用了requestFocusInWindow()，但出现异常：仅当光标原本在文本行尾时，文本框内容会被全部高亮选中，其他光标位置则正常。期望的行为是光标保持在编辑后的行尾，且无内容高亮。

示例代码如下：

import javax.swing.*;
import javax.swing.event.DocumentEvent;
import javax.swing.event.DocumentListener;

public class Main {
    public static void main(String[] args) {
        var frame = new JFrame();
        var panel = new JPanel();
        panel.setLayout(new BoxLayout(panel, BoxLayout.Y_AXIS));
        frame.add(panel);

        var text1 = new JTextField();
        var text2 = new JTextField();
        var text3 = new JTextField();
        moveUpOnEdit(panel, text1, text2, text3);

        frame.pack();
        frame.setVisible(true);
    }

    public static void moveUpOnEdit(JPanel container, JTextField... textFields) {
        for (JTextField textField : textFields) {
            container.add(textField);
            textField.getDocument().addDocumentListener(new DocumentListener() {
                public void insertUpdate(DocumentEvent e) {changedUpdate(e);}

                public void removeUpdate(DocumentEvent e) {changedUpdate(e);}

                public void changedUpdate(DocumentEvent e) {
                    container.remove(textField);
                    container.add(textField, 0);
                    container.revalidate();
                    textField.requestFocusInWindow();
                }
            });
        }
    }
}

我已经尝试过以下方法，但均未解决问题：

• 使用UIManager.put("TextComponent.selectAllOnFocusPolicy", "never");
• 直接调整光标位置
• 修改高亮器

解决方案 #

问题核心是组件重新添加后，requestFocusInWindow()会触发Swing默认的焦点选中行为，光标在末尾时该行为被放大。解决思路是先记录编辑后的光标位置，在UI刷新完成后恢复位置并取消选中状态。

修改后的moveUpOnEdit方法代码如下：

public static void moveUpOnEdit(JPanel container, JTextField... textFields) {
    for (JTextField textField : textFields) {
        container.add(textField);
        textField.getDocument().addDocumentListener(new DocumentListener() {
            public void insertUpdate(DocumentEvent e) {changedUpdate(e);}

            public void removeUpdate(DocumentEvent e) {changedUpdate(e);}

            public void changedUpdate(DocumentEvent e) {
                // 记录编辑后的光标位置
                int caretPos = textField.getCaretPosition();
                
                container.remove(textField);
                container.add(textField, 0);
                container.revalidate();
                container.repaint(); // 确保布局刷新完成
                
                // 延迟执行焦点与光标操作，等待UI更新完毕
                SwingUtilities.invokeLater(() -> {
                    textField.requestFocusInWindow();
                    // 恢复光标位置
                    textField.setCaretPosition(caretPos);
                    // 取消选中状态
                    textField.setSelectionStart(caretPos);
                    textField.setSelectionEnd(caretPos);
                });
            }
        });
    }
}

关键改动说明 #

1. 记录光标位置：在移除组件前获取当前光标位置，确保是编辑后的正确位置。
2. 延迟执行操作：用SwingUtilities.invokeLater将焦点请求和光标恢复放到事件队列末尾，保证组件完成重新布局后再执行。
3. 取消选中状态：将选中起始和结束位置设为同一值，彻底清除高亮选中效果。

修改后，无论光标原本在什么位置，文本框移至顶部后都会保持光标在编辑后的位置，且不会出现全选高亮。

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