Класс JFormattedTextField

@JavaBean
public class JFormattedTextField
extends JTextField

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

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

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

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 будет вызван всякий раз, когда нажата клавиша 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.