javax.swing.text

Класс DefaultFormatter

java.lang. Объект

javax.swing.JFormattedTextField.AbstractFormatter

javax.swing.text. DefaultFormatter

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

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

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

InternationalFormatter, MaskFormatter

public class DefaultFormatter
extends JFormattedTextField.AbstractFormatter
implements Cloneable, Serializable

DefaultFormatter форматы aribtrary объекты. Форматирование делается, вызывая toString метод. Чтобы преобразовать значение назад в Строку, Ваш класс должен предоставить конструктору, который берет Строковый параметр. Если никакой единственный конструктор параметра, который берет Строку, не будет найден, то возвращенным значением будет Строка, в которую передают stringToValue.

Экземпляры DefaultFormatter не может использоваться в многократных экземплярах JFormattedTextField. Уже получить копию сконфигурированный DefaultFormatter, используйте clone метод.

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

С тех пор:

1.4

См. Также:

JFormattedTextField.AbstractFormatter

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

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

Конструктор и Описание
DefaultFormatter() Создает DefaultFormatter.

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

Методы

Модификатор и Тип	Метод и Описание
Объект	clone() Создает копию DefaultFormatter.
boolean	getAllowsInvalid() Возвраты, позволяют ли отредактированному значению быть недопустимым долго.
boolean	getCommitsOnValidEdit() Возвраты, когда редактирования публикуются назад к JFormattedTextField.
protected DocumentFilter	getDocumentFilter() Возвраты DocumentFilter используемый, чтобы ограничить символы, которые могут быть введены в JFormattedTextField.
protected NavigationFilter	getNavigationFilter() Возвраты NavigationFilter используемый, чтобы ограничить, куда курсор может быть помещен.
boolean	getOverwriteMode() Возвращает поведение, вставляя символы.
Class<?>	getValueClass() Возвраты, что класс, который используется, чтобы создать новые Объекты.
void	install(JFormattedTextField ftf) Установки DefaultFormatter на деталь JFormattedTextField.
void	setAllowsInvalid(boolean allowsInvalid) Наборы, позволяют ли отредактированному значению быть недопустимым долго (то есть, stringToValue броски a ParseException).
void	setCommitsOnValidEdit(boolean commit) Наборы, когда редактирования публикуются назад к JFormattedTextField.
void	setOverwriteMode(boolean overwriteMode) Конфигурирует поведение, вставляя символы.
void	setValueClass(Class<?> valueClass) Наборы, что класс, который используется, чтобы создать новые Объекты.
Объект	stringToValue(String string) Преобразовывает переданный в Строке в экземпляр getValueClass посредством конструктора, который берет Строковый параметр.
Строка	valueToString(Object value) Преобразовывает переданный в Объекте в Строку посредством toString метод.

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

getActions, getFormattedTextField, invalidEdit, setEditValid, uninstall

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

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

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

DefaultFormatter

public DefaultFormatter()

Создает DefaultFormatter.

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

установка

public void install(JFormattedTextField ftf)

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

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

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

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

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

install в классе JFormattedTextField.AbstractFormatter

Параметры:

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

setCommitsOnValidEdit

public void setCommitsOnValidEdit(boolean commit)

Наборы, когда редактирования публикуются назад к JFormattedTextField. Если это правда, commitEdit вызывается после каждого допустимого редактирования (любое время текст редактируется). С другой стороны, если это - ложь чем DefaultFormatter не публикует редактирования назад к JFormattedTextField. Также, единственное время значение JFormattedTextField изменится то, когда commitEdit вызывается на JFormattedTextField, обычно то, когда входят, нажимается или листы фокуса JFormattedTextField.

Параметры:

commit - Используемый, чтобы указать, когда редактирования передаются назад JTextComponent

getCommitsOnValidEdit

public boolean getCommitsOnValidEdit()

Возвраты, когда редактирования публикуются назад к JFormattedTextField.

Возвраты:

истина, если редактирования фиксируются после evey допустимое редактирование

setOverwriteMode

public void setOverwriteMode(boolean overwriteMode)

Конфигурирует поведение, вставляя символы. Если overwriteMode истина (значение по умолчанию), новые символы перезаписывают существующие символы в модели.

Параметры:

overwriteMode - Указывает, используется ли режим перезаписи или сверхзабастовки

getOverwriteMode

public boolean getOverwriteMode()

Возвращает поведение, вставляя символы.

Возвраты:

истина, если недавно вставленные символы перезаписывают существующие символы

setAllowsInvalid

public void setAllowsInvalid(boolean allowsInvalid)

Наборы, позволяют ли отредактированному значению быть недопустимым долго (то есть, stringToValue броски a ParseException). Часто удобно позволить пользователю временно вводить недопустимое значение.

Параметры:

allowsInvalid - Используемый, чтобы указать, должно ли отредактированное значение всегда быть допустимым

getAllowsInvalid

public boolean getAllowsInvalid()

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

Возвраты:

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

setValueClass

public void setValueClass(Class<?> valueClass)

Наборы, что класс, который используется, чтобы создать новые Объекты. Если у переданного в классе не будет единственного конструктора параметра, который берет Строку, то Строковые значения будут использоваться.

Параметры:

valueClass - Класс, используемый, чтобы создать возвращаемое значение из stringToValue

getValueClass

public Class<?> getValueClass()

Возвраты, что класс, который используется, чтобы создать новые Объекты.

Возвраты:

Класс, привыкший к constuct возвращаемому значению от stringToValue

stringToValue

public Object stringToValue(String string)
                     throws ParseException

Преобразовывает переданный в Строке в экземпляр getValueClass посредством конструктора, который берет Строковый параметр. Если getValueClass нуль возвратов, Класс текущей стоимости в JFormattedTextField будет использоваться. Если это будет нулем, то Строка будет возвращена. Если конструктор thows исключение, a ParseException будет брошен. Если нет никакого единственного Строкового конструктора параметра, string будет возвращен.

Определенный:

stringToValue в классе JFormattedTextField.AbstractFormatter

Параметры:

string - Строка, чтобы преобразовать

Возвраты:

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

Броски:

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

valueToString

public String valueToString(Object value)
                     throws ParseException

Преобразовывает переданный в Объекте в Строку посредством toString метод.

Определенный:

valueToString в классе JFormattedTextField.AbstractFormatter

Параметры:

value - Значение, чтобы преобразовать

Возвраты:

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

Броски:

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

getDocumentFilter

protected DocumentFilter getDocumentFilter()

Возвраты DocumentFilter используемый, чтобы ограничить символы, которые могут быть введены в JFormattedTextField.

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

getDocumentFilter в классе JFormattedTextField.AbstractFormatter

Возвраты:

DocumentFilter, чтобы ограничить редактирования

getNavigationFilter

protected NavigationFilter getNavigationFilter()

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

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

getNavigationFilter в классе JFormattedTextField.AbstractFormatter

Возвраты:

NavigationFilter, чтобы ограничить навигацию

клон

public Object clone()
             throws CloneNotSupportedException

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

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

clone в классе JFormattedTextField.AbstractFormatter

Возвраты:

копия DefaultFormatter

Броски:

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

См. Также:

Cloneable