javax.swing
类 JFormattedTextField

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.text.JTextComponent
                  javax.swing.JTextField
                      javax.swing.JFormattedTextField

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable, SwingConstants

public class JFormattedTextField
     

      extends 
      JTextField
     

JFormattedTextField 扩展了 JTextField，添加了对格式化任意值的支持，以及一旦用户编辑了文本就检索特定对象的支持。以下代码说明了如何配置 JFormattedTextField 来编辑日期：

   JFormattedTextField ftf = new JFormattedTextField();
   ftf.setValue(new Date());
 

一旦创建了 JFormattedTextField，就可以通过添加 PropertyChangeListener 的方式来侦听编辑更改，并且使用属性名 value 来侦听 PropertyChangeEvent。

JFormattedTextField 允许配置在失去焦点时应该采取的措施。可能的值为：

JFormattedTextField 允许焦点离开，即使当前编辑的值是无效的也是如此。要在 JFormattedTextField 处于无效编辑状态时锁定焦点，可以附加一个 InputVerifier。以下代码片断显示了这种 InputVerifier 的可能实现：

 public class FormattedTextFieldVerifier extends InputVerifier {
     public boolean verify(JComponent input) {
         if (input instanceof JFormattedTextField) {
             JFormattedTextField ftf = (JFormattedTextField)input;
             AbstractFormatter formatter = ftf.getFormatter();
             if (formatter != null) {
                 String text = ftf.getText();
                 try {
                      formatter.stringToValue(text);
return true;
                  } catch (ParseException pe) {
                      return false;
                  }
              }
          }
return true;
      }
      public boolean shouldYieldFocus(JComponent input) {
          return verify(input);
      }
  }
 

或者，也可以调用 commitEdit，这也会提交该值。

JFormattedTextField 本身不执行格式化，而是通过从 JFormattedTextField.AbstractFormatterFactory 实例获得的 JFormattedTextField.AbstractFormatter 实例完成格式化。通过 install 方法的方式使 JFormattedTextField.AbstractFormatter 的实例处于激活状态时会通知它们，此时 JFormattedTextField.AbstractFormatter 可以安装其所需的任何内容，通常是 DocumentFilter。类似地，当 JFormattedTextField 不再需要 AbstractFormatter 时，它会调用 uninstall。

JFormattedTextField 通常在获得或丢失焦点时查询 AbstractFormatterFactory 以找到 AbstractFormat。但根据焦点丢失策略也可以更改此行为。如果焦点丢失策略是 JFormattedTextField.PERSIST 并且已编辑了 JFormattedTextField，则在值提交之前不会查询 AbstractFormatterFactory。类似地，如果焦点丢失策略是 JFormattedTextField.COMMIT 并且从 stringToValue 中抛出异常，则丢失或获得焦点时不查询 AbstractFormatterFactory。

JFormattedTextField.AbstractFormatter 还负责确定何时将值提交给 JFormattedTextField。某些 JFormattedTextField.AbstractFormatter 在每次编辑时都提供新值，而其他的则从不提交该值。可以强行从当前的 JFormattedTextField.AbstractFormatter 获得当前值，方法是调用 commitEdit。每当在 JFormattedTextField 中按下了 return 键，就调用 commitEdit。

如果尚未显式地设置 AbstractFormatterFactory，则在调用 setValue 后（假定 value 是非 null 的），根据 value 类型的 Class 设置该值。例如，在以下代码中将创建一个合适的 AbstractFormatterFactory 和 AbstractFormatter，以处理数字的格式化：

   JFormattedTextField tf = new JFormattedTextField();
   tf.setValue(new Number(100));
 

警告：由于 AbstractFormatter 通常在 Document 上安装一个 DocumentFilter，在 JFormattedTextField 上安装一个 NavigationFilter，所以您不应安装自己的过滤器。如果您安装了，则会看到奇怪的行为，因为将无法强制执行 AbstractFormatter 的编辑策略。

警告：Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

从以下版本开始：

1.4