javax.swing

Class InputVerifier

java.lang.Object

javax.swing.InputVerifier

public abstract class InputVerifier
extends Object

这个课程的目的是帮助客户通过带有文本字段的GUI来平滑地聚焦导航。 这样的GUI通常需要在允许用户导出文本字段之前确保用户输入的文本是有效的（例如，它是正确的格式）。 为此，客户端创建一个InputVerifier的子类，并使用JComponent的setInputVerifier方法，将其子类的实例附加到其想要验证的输入的JComponent中。 在焦点转移到请求它的另一个Swing组件之前，调用输入验证器的shouldYieldFocus方法。 仅当该方法返回true 。

以下示例有两个文本字段，第一个文本字段要求用户输入字符串“pass”。 如果在第一个文本字段中输入该字符串，则用户可以通过在其中单击或按TAB来前进到第二个文本字段。 但是，如果在第一个文本字段中输入另一个字符串，则用户将无法将焦点转移到第二个文本字段。

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

 // This program demonstrates the use of the Swing InputVerifier class.
 // It creates two text fields; the first of the text fields expects the
 // string "pass" as input, and will allow focus to advance out of it
 // only after that string is typed in by the user.

 public class VerifierTest extends JFrame {
     public VerifierTest() {
         JTextField tf1 = new JTextField ("Type \"pass\" here");
         getContentPane().add (tf1, BorderLayout.NORTH);
         tf1.setInputVerifier(new PassVerifier());

         JTextField tf2 = new JTextField ("TextField2");
         getContentPane().add (tf2, BorderLayout.SOUTH);

         WindowListener l = new WindowAdapter() {
             public void windowClosing(WindowEvent e) {
                 System.exit(0);
             }
         };
         addWindowListener(l);
     }

     class PassVerifier extends InputVerifier {
         public boolean verify(JComponent input) {
             JTextField tf = (JTextField) input;
             return "pass".equals(tf.getText());
         }
     }

     public static void main(String[] args) {
         Frame f = new VerifierTest();
         f.pack();
         f.setVisible(true);
     }
 } 

从以下版本开始：

1.3

构造方法摘要

构造方法

Constructor and Description
InputVerifier()

方法摘要

Modifier and Type	Method and Description
boolean	shouldYieldFocus(JComponent input) 致电 verify(input)以确保输入有效。
abstract boolean	verify(JComponent input) 检查JComponent的输入是否有效。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

InputVerifier

public InputVerifier()

方法详细信息

verify

public abstract boolean verify(JComponent input)

检查JComponent的输入是否有效。 这种方法应该没有副作用。 它返回一个布尔值，指示参数输入的状态。

参数

input - 要验证的JComponent

结果

true当有效时， false无效时

另请参见：

JComponent.setInputVerifier(javax.swing.InputVerifier) ， JComponent.getInputVerifier()

shouldYieldFocus

public boolean shouldYieldFocus(JComponent input)

致电verify(input)以确保输入有效。 这种方法可以有副作用。 特别地，当用户尝试将焦点从参数组件推进到该窗口中的另一个Swing组件时，将调用此方法。 如果此方法返回true ，则焦点正常传输; 如果它返回false ，则焦点保留在参数组件中。

参数

input - 要验证的JComponent

结果

true当有效时， false无效时

另请参见：

JComponent.setInputVerifier(javax.swing.InputVerifier) ， JComponent.getInputVerifier()