Класс JFormattedTextField.AbstractFormatter

java.lang.Object

javax.swing.JFormattedTextField.AbstractFormatter

Все реализованные интерфейсы:: Serializable

Прямые известные подклассы:: DefaultFormatter

Вложенный класс:: JFormattedTextField

public abstract static class JFormattedTextField.AbstractFormatter extends Object implements Serializable

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

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

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

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

С:: 1.4

Краткое описание конструкторов

AbstractFormatter()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает копию `AbstractFormatter`.
`protected Action[]`	`getActions()`	Подклассы и переопределение, если вы хотите предоставить настраиваемый набор `Action`.
`protected DocumentFilter`	`getDocumentFilter()`	Подклассы и переопределение, если вы хотите предоставить `DocumentFilter` для ограничения вводимых данных.
`protected JFormattedTextField`	`getFormattedTextField()`	Возвращает текущий `JFormattedTextField`, на котором установлен `AbstractFormatter`.
`protected NavigationFilter`	`getNavigationFilter()`	Подклассы и переопределение, если вы хотите предоставить фильтр для ограничения навигации пользователя.
`void`	`install(JFormattedTextField ftf)`	Устанавливает `AbstractFormatter` на определенный `JFormattedTextField`.
`protected void`	`invalidEdit()`	Это необходимо вызывать, когда пользователь вводит недопустимый символ.
`protected void`	`setEditValid(boolean valid)`	Вызовите это, чтобы обновить свойство `editValid` `JFormattedTextField`.
`abstract Object`	`stringToValue(String text)`	Парсит `text`, возвращая произвольный объект.
`void`	`uninstall()`	Отменяет установку любого состояния, которое может быть установлено `AbstractFormatter` на `JFormattedTextField`.
`abstract String`	`valueToString(Object value)`	Возвращает строковое значение для отображения `value`.

Методы, объявленные в классе java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

AbstractFormatter

protected AbstractFormatter()

Конструктор для вызова подклассами.

Подробное описание методов

install

public void install(JFormattedTextField ftf)

Устанавливает AbstractFormatter на определённое JFormattedTextField. Это вызовет valueToString для преобразования текущего значения из JFormattedTextField в строку. Затем это установит Action из getActions, DocumentFilter возвращаемое из getDocumentFilter, и NavigationFilter возвращаемое из getNavigationFilter на JFormattedTextField.

Подклассы обычно будут переопределять этот метод только в случае необходимости установки дополнительных слушателей на JFormattedTextField.

Если при преобразовании текущего значения в строку возникает ошибка, это установит текст в пустую строку и отметит JFormattedTextField как находящийся в недопустимом состоянии.

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

Параметры:: 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.

Требования к реализации:: По умолчанию возвращается null.
Возвращает:: DocumentFilter для ограничения редактирования

getNavigationFilter

protected NavigationFilter getNavigationFilter()

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

Требования к реализации:: По умолчанию возвращается null.
Возвращает:: NavigationFilter для ограничения навигации

clone

protected Object clone() throws CloneNotSupportedException

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

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

clone в классе Object

Возвращает:

Копию AbstractFormatter

Исключения:

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

См. также:

Cloneable

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/swing/JFormattedTextField.AbstractFormatter.html