java - 如何防止在调度事件后将字符输入到 JTextField 中？

Question

在我的 MainWindow 类(一个 JFrame)中，我使用“+”和“-”键作为热键来向上或向下修改某个名为 DegreeField 的 JTextField 的值。我将具有以下dispatchKeyEventMethod的KeyEventDispatcher添加到我的KeyboardFocusManger:

        @Override
        public boolean dispatchKeyEvent(KeyEvent evt) {
            if(simPanel.main.isFocused()){
                int type = evt.getID();
                if(type == KeyEvent.KEY_PRESSED){
                    int keyCode = evt.getKeyCode();
                    switch(keyCode){
                        // other cases
                        case KeyEvent.VK_PLUS:
                            // increase degreeField by 1, if double
                            // otherwise set it to "270.0"
                            return true;
                        case KeyEvent.VK_MINUS:
                            // decrease degreeField by 1, if double
                            // otherwise set it to "270.0"
                            return true;
                        default:
                            return false;
                    }
                }
                else if(type == KeyEvent.KEY_RELEASED){
                    // irrelevant
                    return false;
                }
            }
            return false;
        }

KeyEventDispatcher 工作并且 DegreeField 的文本按预期修改。但是，当我聚焦另一个 JTextField 时，“+”或“-”也会输入到该字段中。

自从我返回 true 以来，我的印象是该事件不应再由我关注的 JTextField 调度。使用 NetBeans 调试器，我在相关案例中放置了一个断点，并检查了焦点文本字段的文本。当时没有附加+。因此，在我完成分派(dispatch)此事件并返回 true 后，会附加 +。

有人有任何想法吗，我怎样才能真正阻止该事件进一步传递？

我知道我可以在文本字段上放置一个额外的监听器以防止输入“+”和“-”字符，但我更喜欢一个也适用于非字符键的解决方案。 (我对向上和向下箭头键也有类似的问题；它不会破坏任何东西，只是烦人地循环浏览我的文本字段)。

<小时/>

感谢 MadProgrammer 的帮助:

InputMap im = senderXField.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
ActionMap am = senderXField.getActionMap();

im.put(KeyStroke.getKeyStroke(KeyEvent.VK_PLUS, 0), "Pressed.+");
im.put(KeyStroke.getKeyStroke(KeyEvent.VK_UP, 0), "Pressed.up");

am.put("Pressed.+", angleUpAction); // works fine

可悲的是

am.put("Pressed.up", indexUpAction); // does not trigger

这适用于所有箭头键。他们做他们平常的事情(分别移动光标或焦点)并且不触发操作。如果我使用 WHEN_FOCUSED InputMap，它们会按预期工作，使我相信它们的默认行为是作为可覆盖的 WHEN_FOCUSED 级别的 KeyBinding 实现的。

虽然从技术上来说，作为一种解决方法，我可以为主窗口中的所有文本字段实现箭头键命令，但这会......很奇怪。我希望有一个更好的解决方案，让我保留整个窗口的命令，但也覆盖它们的默认行为。

<小时/>

已解决

Answer 1

I add a KeyEventDispatcher with the following dispatchKeyEventMethod to my KeyboardFocusManger:

在很多层面上不，不，不，不

您的问题的实际答案有两个。

首先，使用 DocumentFilter 过滤掉不需要的输入，请参阅 Implementing a DocumentFilter了解更多详情。

使用它的原因归结为许多问题......

• KeyListener 可能会在内容提交到底层 Document 模型后收到通知
• 关键处理例程也可能会忽略消耗状态
• KeyListener 当用户将文本粘贴到字段中时无法捕获用例
• KeyListener 在调用 setText 时无法捕获用例
• KeyListener 对于尝试过滤内容而言，总的来说是一个糟糕的选择。

其次，您应该使用 Key Bindings API而不是KeyEventDispatcher。

KeyEventDispatcher 的级别较低，无法满足您的需求；难以维护；没有考虑可能需要与相同击键相关联的其他操作，并且很快就会变得困惑。

按键绑定(bind)也更容易重复使用。您可以将按键绑定(bind)使用的 Action 应用到按钮，甚至应用到更全局的状态。它们还可以用于将多个键绑定(bind)到单个操作，例如，+ 键(在数字键盘上)和 Shift+= 键

import java.awt.EventQueue;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.event.ActionEvent;
import java.awt.event.KeyEvent;
import javax.swing.AbstractAction;
import javax.swing.ActionMap;
import javax.swing.InputMap;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JTextField;
import javax.swing.KeyStroke;
import javax.swing.UIManager;
import javax.swing.UnsupportedLookAndFeelException;
import javax.swing.text.AbstractDocument;
import javax.swing.text.AttributeSet;
import javax.swing.text.BadLocationException;
import javax.swing.text.Document;
import javax.swing.text.DocumentFilter;

public class Text {

    public static void main(String[] args) {
        new Text();
    }

    public Text() {
        EventQueue.invokeLater(new Runnable() {
            @Override
            public void run() {
                try {
                    UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
                } catch (ClassNotFoundException | InstantiationException | IllegalAccessException | UnsupportedLookAndFeelException ex) {
                    ex.printStackTrace();
                }

                JFrame frame = new JFrame("Testing");
                frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
                frame.add(new TestPane());
                frame.pack();
                frame.setLocationRelativeTo(null);
                frame.setVisible(true);
            }
        });
    }

    public class TestPane extends JPanel {

        public TestPane() {
            setLayout(new GridBagLayout());
            JTextField field = new JTextField(10);
            ((AbstractDocument)field.getDocument()).setDocumentFilter(new IntegerDocumentFilter());
            
            GridBagConstraints gbc = new GridBagConstraints();
            gbc.gridwidth = GridBagConstraints.REMAINDER;
            add(field, gbc);
            
            InputMap im = field.getInputMap(WHEN_IN_FOCUSED_WINDOW);
            ActionMap am = field.getActionMap();

            im.put(KeyStroke.getKeyStroke(KeyEvent.VK_EQUALS, KeyEvent.SHIFT_DOWN_MASK), "Pressed.+");
            im.put(KeyStroke.getKeyStroke(KeyEvent.VK_PLUS, 0), "Pressed.+");
            im.put(KeyStroke.getKeyStroke(KeyEvent.VK_MINUS, 0), "Pressed.-");

            am.put("Pressed.+", new DeltaAction(field, 1));
            am.put("Pressed.-", new DeltaAction(field, -1));
            
            add(new JButton("Test"), gbc);
        }

        protected class DeltaAction extends AbstractAction {

            private JTextField field;
            private int delta;

            public DeltaAction(JTextField field, int delta) {
                this.field = field;
                this.delta = delta;
            }

            @Override
            public void actionPerformed(ActionEvent e) {
                String text = field.getText();
                if (text == null || text.isEmpty()) {
                    text = "0";
                }
                try {
                    int value = Integer.parseInt(text);
                    value += delta;
                    field.setText(Integer.toString(value));
                } catch (NumberFormatException exp) {
                    System.err.println("Can not convert " + text + " to an int");
                }
            }
        }

        public class IntegerDocumentFilter extends DocumentFilter {

            @Override
            public void insertString(DocumentFilter.FilterBypass fb, int offset, String text, AttributeSet attr) throws BadLocationException {
                try {
                    StringBuilder sb = new StringBuilder();
                    Document document = fb.getDocument();
                    sb.append(document.getText(0, offset));
                    sb.append(text);
                    sb.append(document.getText(offset, document.getLength()));
                    
                    Integer.parseInt(sb.toString());
                    super.insertString(fb, offset, text, attr);
                } catch (NumberFormatException exp) {
                    System.err.println("Can not insert " + text + " into document");
                }
            }

            @Override
            public void replace(DocumentFilter.FilterBypass fb, int offset, int length, String string, AttributeSet attr) throws BadLocationException {
                if (length > 0) {
                    fb.remove(offset, length);
                }
                insertString(fb, offset, string, attr);
            }
        }

    }

}