javax.swing.text

Класс InternationalFormatter

java.lang. Объект

javax.swing.JFormattedTextField.AbstractFormatter

javax.swing.text. DefaultFormatter

javax.swing.text. InternationalFormatter

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

Сериализуемый, Cloneable

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

DateFormatter, NumberFormatter

public class InternationalFormatter
extends DefaultFormatter

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

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

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

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

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

InternationalFormatter's поведение stringToValue немного отличается чем тот из DefaultTextFormatter, это делает следующее:

1. parseObject вызывается на Format определенный setFormat
2. Если Класс был установлен для значений (setValueClass), supers реализация вызывается, чтобы преобразовать значение, возвращенное из parseObject к соответствующему классу.
3. Если a ParseException не был брошен, и значение вне минуты a / максимальный a ParseException бросается.
4. Значение возвращается.

InternationalFormatter реализации stringToValue этим способом так, чтобы можно было определить альтернативный Класс чем Format может возвратиться.

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

С тех пор:

1.4

См. Также:

Format, Comparable

Сводка конструктора

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

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

Сводка метода

Методы

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

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 не нуль, valueClass будет установлен в тот из класса minimum.

Параметры:

minimum - Минимальное юридическое значение, которое может быть введено

См. Также:

DefaultFormatter.setValueClass(java.lang.Class<?>)

getMinimum

public Comparable getMinimum()

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

Возвраты:

Минимальное юридическое значение, которое может быть введено

setMaximum

public void setMaximum(Comparable max)

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

Параметры:

max - Максимальное юридическое значение, которое может быть введено

См. Также:

DefaultFormatter.setValueClass(java.lang.Class<?>)

getMaximum

public Comparable getMaximum()

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

Возвраты:

Максимальное юридическое значение, которое может быть введено

установка

public void install(JFormattedTextField ftf)

Установки DefaultFormatter на деталь JFormattedTextField. Это вызовет valueToString преобразовать текущую стоимость из JFormattedTextField к Строке. Это тогда установит Actions от getActions, DocumentFilter возвращенный из getDocumentFilter и NavigationFilter возвращенный из getNavigationFilter на JFormattedTextField.

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

Если есть a ParseException в преобразовании текущей стоимости к Строке это установит текст в пустую Строку, и отметит JFormattedTextField как являющийся в недопустимом состоянии.

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

Переопределения:

install в классе DefaultFormatter

Параметры:

ftf - JFormattedTextField, чтобы отформатировать для, может быть нулевое удаление указания от текущего 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 - String преобразовать

Возвраты:

Object представление текста

Броски:

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

getFields

public Format.Field[] getFields(int offset)

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

Параметры:

offset - смещение в текст, который будет исследован

Возвраты:

Формат. Полевые константы связались с текстом в данной позиции.

клон

public Object clone()
             throws CloneNotSupportedException

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

Переопределения:

clone в классе DefaultFormatter

Возвраты:

копия DefaultFormatter

Броски:

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

См. Также:

Cloneable

getActions

protected Action[] getActions()

Если getSupportsIncrement возвращает true, это возвращает два Действия, подходящие для того, чтобы постепенно увеличить/постепенно уменьшить значение.

Переопределения:

getActions в классе JFormattedTextField.AbstractFormatter

Возвраты:

Массив Действий, чтобы установить на JFormattedTextField