- java.lang.Object
-
- javax.swing.InputVerifier
-
public abstract class InputVerifier extends Object
The purpose of this class is to help clients support smooth focus navigation through GUIs with text fields. Such GUIs often need to ensure that the text entered by the user is valid (for example, that it's in the proper format) before allowing the user to navigate out of the text field. To do this, clients create a subclass ofInputVerifier
and, usingJComponent
'ssetInputVerifier
method, attach an instance of their subclass to theJComponent
whose input they want to validate. Before focus is transfered to another Swing component that requests it, the input verifier'sshouldYieldFocus
method is called. Focus is transfered only if that method returnstrue
.The following example has two text fields, with the first one expecting the string "pass" to be entered by the user. If that string is entered in the first text field, then the user can advance to the second text field either by clicking in it or by pressing TAB. However, if another string is entered in the first text field, then the user will be unable to transfer focus to the second text field.
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); } }
- Since:
- 1.3
-
-
Constructor Summary
Constructors Constructor and Description InputVerifier()
-
Method Summary
Methods Modifier and Type Method and Description boolean
shouldYieldFocus(JComponent input)
Callsverify(input)
to ensure that the input is valid.abstract boolean
verify(JComponent input)
Checks whether the JComponent's input is valid.
-
-
-
Method Detail
-
verify
public abstract boolean verify(JComponent input)
Checks whether the JComponent's input is valid. This method should have no side effects. It returns a boolean indicating the status of the argument's input.- Parameters:
input
- the JComponent to verify- Returns:
true
when valid,false
when invalid- See Also:
JComponent.setInputVerifier(javax.swing.InputVerifier)
,JComponent.getInputVerifier()
-
shouldYieldFocus
public boolean shouldYieldFocus(JComponent input)
Callsverify(input)
to ensure that the input is valid. This method can have side effects. In particular, this method is called when the user attempts to advance focus out of the argument component into another Swing component in this window. If this method returnstrue
, then the focus is transfered normally; if it returnsfalse
, then the focus remains in the argument component.- Parameters:
input
- the JComponent to verify- Returns:
true
when valid,false
when invalid- See Also:
JComponent.setInputVerifier(javax.swing.InputVerifier)
,JComponent.getInputVerifier()
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
22/12/2024 10:18:00 Cette version de la page est en cache (à la date du 22/12/2024 10:18:00) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 29/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/swing/InputVerifier.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.