Класс 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 вызывается при каждом нажатии клавиши Enter в 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 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.