Класс JFormattedTextField.AbstractFormatter

public abstract static class JFormattedTextField.AbstractFormatter
extends Object
implements Serializable

Экземпляры AbstractFormatter используются JFormattedTextField для обработки преобразования как из объекта в строку, так и обратно из строки в объект. AbstractFormatter также могут накладывать политики редактирования или навигации, или изменять JFormattedTextField любым способом, чтобы обеспечить необходимую политику.

AbstractFormatter может быть активным только в одном JFormattedTextField одновременно. JFormattedTextField вызывает install, когда готов к его использованию, а затем uninstall при завершении. Подклассы, которые хотят установить дополнительное состояние, должны переопределить install и корректно обработать сообщение super.

Подклассы должны переопределить методы преобразования stringToValue и valueToString. По желанию они могут переопределить getActions, getNavigationFilter и getDocumentFilter для ограничения JFormattedTextField определенным образом.

Подклассы, которые допускают, что JFormattedTextField может находиться в временно недопустимом состоянии, должны вызывать setEditValid в соответствующие моменты.

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

AbstractFormatter

public AbstractFormatter()

Методы

install

public void install(JFormattedTextField ftf)

Параметры:

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

uninstall

public void uninstall()

Удаляет любое состояние, которое AbstractFormatter мог установить на JFormattedTextField . Это сбросит DocumentFilter, NavigationFilter и дополнительные Action , установленные на JFormattedTextField.

stringToValue

public abstract Object stringToValue(String text)
                              throws ParseException

Разбирает text и возвращает произвольный объект. Некоторые форматировщики могут возвращать null.

Параметры:

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

Возвращает:

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

Исключения:

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

valueToString

public abstract String valueToString(Object value)
                              throws ParseException

Возвращает строковое значение для отображения value.

Параметры:

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

Возвращает:

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

Исключения:

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

getFormattedTextField

protected JFormattedTextField getFormattedTextField()

Возвращает текущий JFormattedTextField , на котором установлен AbstractFormatter.

Возвращает:

JFormattedTextField для форматирования

invalidEdit

protected void invalidEdit()

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

setEditValid

protected void setEditValid(boolean valid)

Вызывается для обновления свойства editValid JFormattedTextField . Если вы хотите принудительно обеспечить, что JFormattedTextField всегда находится в допустимом состоянии, вам никогда не нужно будет вызывать этот метод.

Параметры:

valid - Допустимое состояние JFormattedTextField

getActions

protected Action[] getActions()

Подклассы и переопределение, если нужно предоставить настраиваемый набор Action. install установит эти значения на JFormattedTextField ActionMap.

Возвращает:

Массив Actions для установки на JFormattedTextField

getDocumentFilter

protected DocumentFilter getDocumentFilter()

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

Возвращает:

DocumentFilter для ограничения редактирования

getNavigationFilter

protected NavigationFilter getNavigationFilter()

Подклассы и переопределение, если нужно предоставить фильтр для ограничения навигации пользователя. install установит возвращаемое значение на JFormattedTextField.

Возвращает:

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

clone

protected Object clone()
                throws CloneNotSupportedException

Клонирует AbstractFormatter . Возвращаемый экземпляр не связан с JFormattedTextField.

Переопределяет:

clone в классе Object

Возвращает:

Копию AbstractFormatter

Исключения:

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

См. также:

Cloneable