InternationalFormatter (Платформа Java SE 8 b92)

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 к соответствующему class.
3. Если a ParseException не был брошен, и значение вне минуты a / максимальный a ParseException бросается.
4. Значение возвращается.
InternationalFormatter реализации stringToValue этим способом так, чтобы можно было определить альтернативный Класс чем Format может возвратиться.
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками 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`.

Методы, наследованные от class javax.swing.text. DefaultFormatter
getAllowsInvalid, getCommitsOnValidEdit, getDocumentFilter, getNavigationFilter, getOverwriteMode, getValueClass, setAllowsInvalid, setCommitsOnValidEdit, setOverwriteMode, setValueClass

Методы, наследованные от class javax.swing.JFormattedTextField.AbstractFormatter
getFormattedTextField, invalidEdit, setEditValid, uninstall

Методы, наследованные от class 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 будет установлен в тот из class minimum.
    
    Параметры:
    
    minimum - Минимальное юридическое значение, которое может быть введено
    
    См. Также:
    
    DefaultFormatter.setValueClass(java.lang.Class<?>)
  - getMinimum
```
public Comparable getMinimum()
```
    Возвращает минимальное допустимое значение.
    
    Возвраты:
    
    Минимальное юридическое значение, которое может быть введено
  - setMaximum
```
public void setMaximum(Comparable max)
```
    Устанавливает максимальное допустимое значение. Если valueClass не был определен, и max не нуль, valueClass будет установлен в тот из class 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 в class DefaultFormatter
    
    Параметры:
    
    ftf - JFormattedTextField, чтобы отформатировать для, может быть нулевое указание, удаляют от текущего JFormattedTextField.
  - valueToString
```
public String valueToString(Object value)
                     throws ParseException
```
    Возвращает Строковое представление Объекта value. Это вызывает format на токе Format.
    
    Переопределения:
    
    valueToString в class DefaultFormatter
    
    Параметры:
    
    value - Значение, чтобы преобразовать
    
    Возвраты:
    
    Строковое представление имеющее значение
    
    Броски:
    
    ParseException - если есть ошибка в преобразовании
  - stringToValue
```
public Object stringToValue(String text)
                     throws ParseException
```
    Возвраты Object представление String text.
    
    Переопределения:
    
    stringToValue в class DefaultFormatter
    
    Параметры:
    
    text - String преобразовать
    
    Возвраты:
    
    Object представление текста
    
    Броски:
    
    ParseException - если есть ошибка в преобразовании
  - getFields
```
public Format.Field[] getFields(int offset)
```
    Возвраты Format.Field константы, связанные с текстом в offset. Если offset не допустимое расположение в текущий текст, это возвратит пустой массив.
    
    Параметры:
    
    offset - смещение в текст, который будет исследован
    
    Возвраты:
    
    Формат. Полевые константы связались с текстом в данной позиции.
  - клон
```
public Object clone()
             throws CloneNotSupportedException
```
    Создает копию DefaultFormatter.
    
    Переопределения:
    
    clone в class DefaultFormatter
    
    Возвраты:
    
    копия DefaultFormatter
    
    Броски:
    
    CloneNotSupportedException - если class объекта не поддерживает Cloneable интерфейс. Подклассы, которые переопределяют clone метод может также выдать это исключение, чтобы указать, что экземпляр не может быть клонирован.
    
    См. Также:
    
    Cloneable
  - getActions
```
protected Action[] getActions()
```
    Если getSupportsIncrement возвращает true, это возвращает два Действия, подходящие для того, чтобы постепенно увеличить/постепенно уменьшить значение.
    
    Переопределения:
    
    getActions в class JFormattedTextField.AbstractFormatter
    
    Возвраты:
    
    Массив Действий, чтобы установить на JFormattedTextField

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс InternationalFormatter

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

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

Методы, наследованные от class javax.swing.text. DefaultFormatter

Методы, наследованные от class javax.swing.JFormattedTextField.AbstractFormatter

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

Деталь конструктора

InternationalFormatter

InternationalFormatter

Деталь метода

setFormat

getFormat

setMinimum

getMinimum

setMaximum

getMaximum

установка

valueToString

stringToValue

getFields

клон

getActions