Класс JFormattedTextField

@JavaBean public class JFormattedTextField extends JTextField

JFormattedTextField расширяет JTextField, добавляя поддержку форматирования произвольных значений, а также извлечения конкретного объекта после редактирования текста пользователем. Следующий пример иллюстрирует настройку JFormattedTextField для редактирования дат:

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

После создания JFormattedTextField вы можете прослушивать изменения в редактировании, добавив PropertyChangeListener и прослушивая PropertyChangeEvent с именем свойства value.

JFormattedTextField позволяет настроить действия при потере фокуса. Возможные конфигурации:

Возможные конфигурации JFormattedTextField и их описания

Значение	Описание
JFormattedTextField.REVERT	Вернуть отображение к значению getValue, возможно, потеряв текущее редактирование.
JFormattedTextField.COMMIT	Сохраняет текущее значение. Если редактируемое значение не считается допустимым значением для AbstractFormatter, то есть возникает ParseException, значение не изменится, и отредактированное значение сохранится.
JFormattedTextField.COMMIT_OR_REVERT	Аналогично COMMIT, но если значение не является допустимым, ведет себя как REVERT.
JFormattedTextField.PERSIST	Не выполнять никаких действий, не получать новое значение AbstractFormatter, и не обновлять значение.

По умолчанию установлено значение JFormattedTextField.COMMIT_OR_REVERT, см. setFocusLostBehavior(int) для получения дополнительной информации.

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.AbstractFormatter, который получается из экземпляра JFormattedTextField.AbstractFormatterFactory. Экземпляры JFormattedTextField.AbstractFormatter уведомляются о своем активации методом install, в этот момент 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. commitEdit вызывается всякий раз, когда нажимается Return в JFormattedTextField.

Если AbstractFormatterFactory не задано явно, он будет установлен на основе Class типа значения после вызова setValue (при условии, что значение не равно null). Например, в следующем коде будут созданы подходящие AbstractFormatterFactory и AbstractFormatter для обработки форматирования чисел:

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

Предупреждение: Так как AbstractFormatter обычно установит DocumentFilter на Document, и NavigationFilter на JFormattedTextField, вы не должны устанавливать свои собственные. В противном случае вы, вероятно, увидите странное поведение, поскольку политика редактирования AbstractFormatter не будет соблюдаться.

Предупреждение: Swing не потокобезопасен. Для получения дополнительной информации см. Политику потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, добавлена поддержка долгосрочного хранения всех JavaBeans в пакет java.beans. Пожалуйста, обратитесь к XMLEncoder.