InputVerifier (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing
类 InputVerifier

java.lang.Object
  javax.swing.InputVerifier

public abstract class InputVerifier
extends Object
extends Object

此类的用途是通过带文本字段的 GUI 帮助客户端支持流畅的焦点导航。在允许用户导航到文本字段以外之前，这类 GUI 常常需要确保用户输入的文本是有效的（例如，文本具有正确的格式）。为做到这一点，客户端要使用 JComponent 的 setInputVerifier 方法创建 InputVerifier 的子类，并将其子类的实例附加到想要验证其输入的 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

构造方法摘要

InputVerifier()


方法摘要

boolean shouldYieldFocus(JComponent input)
          调用 verify(input) 来确保输入是有效的。

abstract boolean verify(JComponent input)
          检查 JComponent 的输入是否有效。

从类 java.lang.Object 继承的方法

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

构造方法摘要
`InputVerifier()`

方法摘要
`boolean`	`shouldYieldFocus(JComponent input)` 调用 `verify(input)` 来确保输入是有效的。
`abstract boolean`	`verify(JComponent input)` 检查 JComponent 的输入是否有效。

从类 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 的输入是否有效。此方法不应有副作用。该方法返回一个指示参数的输入状态的 boolean 值。

参数：: 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()