Класс DefaultFormatter

public class DefaultFormatter
extends JFormattedTextField.AbstractFormatter
implements Cloneable, Serializable

DefaultFormatter форматирует произвольные объекты. Форматирование выполняется путём вызова метода toString. Для преобразования значения обратно в строку, ваш класс должен предоставлять конструктор, принимающий строковый аргумент. Если такой конструктор не найден, возвращаемое значение будет строкой, переданной в stringToValue.

Экземпляры DefaultFormatter не могут быть использованы в нескольких экземплярах JFormattedTextField. Чтобы получить копию уже сконфигурированного DefaultFormatter, используйте метод clone.

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

Конструкторы

DefaultFormatter

public DefaultFormatter()

Создаёт DefaultFormatter.

Методы

install

public void install(JFormattedTextField ftf)

Overrides:

install в классе JFormattedTextField.AbstractFormatter

Параметры:

ftf - JFormattedTextField для форматирования, может быть null, что указывает на удаление из текущего JFormattedTextField.

setCommitsOnValidEdit

public void setCommitsOnValidEdit(boolean commit)

Устанавливает, когда изменения публикуются обратно в JFormattedTextField. Если true, commitEdit вызывается после каждого допустимого изменения (в любой момент, когда текст редактируется). С другой стороны, если false, DefaultFormatter не публикует изменения обратно в JFormattedTextField. Таким образом, значение JFormattedTextField изменяется только при вызове commitEdit на JFormattedTextField, обычно при нажатии Enter или потере фокуса JFormattedTextField.

Параметры:

commit - Используется для указания, когда изменения сохраняются обратно в JTextComponent

getCommitsOnValidEdit

public boolean getCommitsOnValidEdit()

Возвращает, когда изменения публикуются обратно в JFormattedTextField.

Возвращает:

true, если изменения сохраняются после каждого допустимого изменения

setOverwriteMode

public void setOverwriteMode(boolean overwriteMode)

Настраивает поведение при вставке символов. Если overwriteMode равно true (по умолчанию), новые символы перезаписывают существующие в модели.

Параметры:

overwriteMode - Указывает, используется ли режим перезаписи или наложения

getOverwriteMode

public boolean getOverwriteMode()

Возвращает поведение при вставке символов.

Возвращает:

true, если новые вставленные символы перезаписывают существующие

setAllowsInvalid

public void setAllowsInvalid(boolean allowsInvalid)

Устанавливает, разрешено ли значение, которое редактируется, быть недопустимым в течение некоторого времени (то есть, stringToValue выбрасывает ParseException). Часто удобно разрешить пользователю временно ввести недопустимое значение.

Параметры:

allowsInvalid - Используется для указания, должно ли редактируемое значение всегда быть допустимым

getAllowsInvalid

public boolean getAllowsInvalid()

Возвращает, разрешено ли значение, которое редактируется, быть недопустимым в течение некоторого времени.

Возвращает:

false, если редактируемое значение должно всегда быть допустимым

setValueClass

public void setValueClass(Class<?> valueClass)

Устанавливает класс, используемый для создания новых объектов. Если переданный класс не имеет конструктора с одним аргументом, принимающим строку, будут использованы строковые значения.

Параметры:

valueClass - Класс, используемый для построения возвращаемого значения из stringToValue

getValueClass

public Class<?> getValueClass()

Возвращает класс, используемый для создания новых объектов.

Возвращает:

Класс, используемый для построения возвращаемого значения из stringToValue

stringToValue

public Object stringToValue(String string)
                     throws ParseException

Преобразует переданную строку в экземпляр getValueClass с помощью конструктора, принимающего строковый аргумент. Если getValueClass возвращает null, используется класс текущего значения в JFormattedTextField . Если это null, возвращается строка. Если конструктор вызывает исключение, выбрасывается ParseException . Если нет конструктора с единственным строковым аргументом, возвращается string.

Определено в:

stringToValue в классе JFormattedTextField.AbstractFormatter

Параметры:

string - Строка для преобразования

Возвращает:

Объектное представление текста

Исключение:

ParseException - если при преобразовании возникла ошибка

valueToString

public String valueToString(Object value)
                     throws ParseException

Преобразует переданный объект в строку с помощью метода toString.

Определено в:

valueToString в классе JFormattedTextField.AbstractFormatter

Параметры:

value - Значение для преобразования

Возвращает:

Строковое представление значения

Исключение:

ParseException - если при преобразовании возникла ошибка

getDocumentFilter

protected DocumentFilter getDocumentFilter()

Возвращает DocumentFilter , используемый для ограничения символов, которые можно ввести в JFormattedTextField.

Overrides:

getDocumentFilter в классе JFormattedTextField.AbstractFormatter

Возвращает:

DocumentFilter для ограничения изменений

getNavigationFilter

protected NavigationFilter getNavigationFilter()

Возвращает NavigationFilter , используемый для ограничения позиции курсора.

Overrides:

getNavigationFilter в классе JFormattedTextField.AbstractFormatter

Возвращает:

NavigationFilter для ограничения навигации

clone

public Object clone()
             throws CloneNotSupportedException

Создаёт копию DefaultFormatter.

Overrides:

clone в классе JFormattedTextField.AbstractFormatter

Возвращает:

копию DefaultFormatter

Исключение:

CloneNotSupportedException - если класс объекта не поддерживает интерфейс Cloneable . Подклассы, переопределяющие метод clone, также могут выбросить это исключение, чтобы указать, что экземпляр не может быть клонирован.

См. также:

Cloneable