Класс InternationalFormatter

javax.swing.text.InternationalFormatter

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

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

public class InternationalFormatter extends DefaultFormatter

InternationalFormatter расширяет DefaultFormatter, используя экземпляр java.text.Format для обработки преобразования в строку и из строки.

Если getAllowsInvalid() имеет значение false, это запросит Format отформатировать текущий текст при каждом изменении.

Вы можете указать минимальное и максимальное значения с помощью методов setMinimum и setMaximum. Для этого значения, возвращаемые stringToValue, должны быть сравнимы с минимальным и максимальным значениями с помощью интерфейса Comparable.

Будьте внимательны при настройке Format и InternationalFormatter, так как можно создать ситуацию, когда определённые значения нельзя ввести. Рассмотрим формат даты 'M/d/yy', InternationalFormatter, который всегда действителен (setAllowsInvalid(false)), находится в режиме перезаписи (setOverwriteMode(true)) и дату 7/1/99. В этом случае пользователь не сможет ввести двузначный месяц или число. Чтобы избежать этого, формат должен быть 'MM/dd/yy'.

Если InternationalFormatter настроено на разрешение только допустимых значений (setAllowsInvalid(false)), каждое допустимое изменение приведёт к полному сбросу текста JFormattedTextField от Format. Позиция курсора также будет скорректирована при добавлении/удалении символов из результирующей строки.

Поведение InternationalFormatter при stringToValue немного отличается от DefaultTextFormatter, оно выполняет следующее:

parseObject вызывается на Format, указанном setFormat
Если для значений задан класс (setValueClass), вызывается реализация суперкласса для преобразования значения, возвращённого parseObject, в соответствующий класс.
Если не было брошено ParseException, и значение находится вне минимального/максимального, выбрасывается ParseException.
Значение возвращается.

InternationalFormatter реализует stringToValue таким образом, чтобы вы могли указать альтернативный класс, отличный от того, что может вернуть Format.

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

С тех пор:

1.4

См. также:

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

Конструктор	Описание
`InternationalFormatter()`	Создаёт `InternationalFormatter` без указанного `Format`.
`InternationalFormatter(Format format)`	Создаёт `InternationalFormatter` с указанным экземпляром `Format`.

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создаёт копию DefaultFormatter.
`protected Action[]`	`getActions()`	Если `getSupportsIncrement` возвращает true, это возвращает два Action, подходящие для увеличения/уменьшения значения.
`Format.Field[]`	`getFields(int offset)`	Возвращает константы `Format.Field`, связанные с текстом по адресу `offset`.
`Format`	`getFormat()`	Возвращает формат, определяющий допустимые значения, которые можно редактировать и отображать.
`Comparable<?>`	`getMaximum()`	Возвращает максимальное допустимое значение.
`Comparable<?>`	`getMinimum()`	Возвращает минимальное допустимое значение.
`void`	`install(JFormattedTextField ftf)`	Устанавливает `DefaultFormatter` на конкретный `JFormattedTextField`.
`void`	`setFormat(Format format)`	Устанавливает формат, определяющий допустимые значения, которые можно редактировать и отображать.
`void`	`setMaximum(Comparable<?> max)`	Устанавливает максимальное допустимое значение.
`void`	`setMinimum(Comparable<?> minimum)`	Устанавливает минимальное допустимое значение.
`Object`	`stringToValue(String text)`	Возвращает представление `Object` объекта `String` `text`.
`String`	`valueToString(Object value)`	Возвращает строковое представление объекта `value`.

Методы, объявленные в классе javax.swing.text.DefaultFormatter

getAllowsInvalid, getCommitsOnValidEdit, getDocumentFilter, getNavigationFilter, getOverwriteMode, getValueClass, setAllowsInvalid, setCommitsOnValidEdit, setOverwriteMode, setValueClass

Методы, объявленные в классе javax.swing.JFormattedTextField.AbstractFormatter

getFormattedTextField, invalidEdit, setEditValid, uninstall

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

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

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

InternationalFormatter

public InternationalFormatter()

Создаёт InternationalFormatter без указанного Format.

InternationalFormatter

public InternationalFormatter(Format format)

Создаёт InternationalFormatter с указанным экземпляром Format.

Параметры:: format - Экземпляр формата, используемый для преобразования из/в строки

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

setFormat

public void setFormat(Format format)

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

Параметры:: format - Экземпляр Format, используемый для преобразования из/в строки

getFormat

public Format getFormat()

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

Возвращает:: Экземпляр формата, используемый для преобразования из/в строки

setMinimum

public void setMinimum(Comparable<?> minimum)

Устанавливает минимальное допустимое значение. Если valueClass не задан, а minimum не равен null, то valueClass будет установлен для класса minimum.

Параметры:

minimum - Минимальное допустимое значение для ввода

См. также:

getMinimum

public Comparable<?> getMinimum()

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

Возвращает:: Минимальное допустимое значение для ввода

setMaximum

public void setMaximum(Comparable<?> max)

Устанавливает максимальное допустимое значение. Если valueClass не задан, а max не равен null, то valueClass будет установлен для класса max.

Параметры:

max - Максимальное допустимое значение для ввода

См. также:

getMaximum

public Comparable<?> getMaximum()

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

Возвращает:: Максимальное допустимое значение для ввода

install

public void install(JFormattedTextField ftf)

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

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

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

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

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

valueToString

public String valueToString(Object value) throws ParseException

Возвращает строковое представление объекта value. Это вызывает format на текущем Format.

Переопределяет:: valueToString в классе DefaultFormatter
Параметры:: value - Значение для преобразования
Возвращает:: Строковое представление значения
Исключения:: ParseException - если при преобразовании произошла ошибка

stringToValue

public Object stringToValue(String text) throws ParseException

Возвращает представление Object текста String. Это text.

Переопределяет:: stringToValue в классе DefaultFormatter
Параметры:: text - Строка для преобразования
Возвращает:: Представление Object текста
Исключения:: ParseException - если при преобразовании произошла ошибка

getFields

public Format.Field[] getFields(int offset)

Возвращает константы Format.Field, связанные с текстом по позиции offset. Если offset не является допустимой позицией в текущем тексте, возвращает пустой массив.

Параметры:: offset - Смещение в тексте для проверки
Возвращает:: Константы Format.Field, связанные с текстом в заданной позиции.

clone

public Object clone() throws CloneNotSupportedException

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

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

clone в классе DefaultFormatter

Возвращает:

Копию DefaultFormatter

Исключения:

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

См. также:

getActions

protected Action[] getActions()

Если getSupportsIncrement возвращает true, возвращает два объекта Action, подходящих для увеличения/уменьшения значения.

Переопределяет:: getActions в классе JFormattedTextField.AbstractFormatter
Возвращает:: Массив объектов Action для установки на JFormattedTextField

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/InternationalFormatter.html