Класс 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 позволяет покинуть фокус, даже если текущее редактируемое значение не является допустимым. Чтобы заблокировать фокус, пока 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 будет вызываться всякий раз, когда в 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.