javax.swing

クラスInputVerifier

java.lang.Object

javax.swing.InputVerifier

public abstract class InputVerifier
extends Object

このクラスの目的は、クライアントがテキスト・フィールドとGUIを使って、スムーズなフォーカス・ナビゲーションを行えるようにサポートすることです。このようなGUIでは、ユーザーがテキスト・フィールド以外の箇所に移る前に、ユーザーが入力したテキストが有効かどうか、つまり適切な形式であるかを確認する必要があります。これを行うには、クライアントがInputVerifierのサブクラスを生成し、JComponentのsetInputVerifierメソッドを使用して、入力の検証を行うJComponentにサブクラスのインスタンスを接続します。フォーカスを要求する別のSwingコンポーネントにフォーカスを移動する前に、入力ベリファイアのshouldYieldFocusメソッドが呼び出されます。メソッドがtrueを返した場合にだけフォーカスが移動されます。

次の例では2つのテキスト・フィールドがあり、最初のフィールドでは、ユーザーから文字列「pass」が入力されるのを待っています。その文字列が最初のテキスト・フィールドに入力されると、ユーザーは、2番目のフィールドをクリックするか、Tabを押すことによって2番目のテキスト・フィールドに進むことができます。ただし、最初のテキスト・フィールドに別の文字列を入力すると、ユーザーは2番目のテキスト・フィールドにフォーカスを移動することができません。

 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

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()