javax.swing.text

Class DefaultFormatter

java.lang.Object

javax.swing.JFormattedTextField.AbstractFormatter

javax.swing.text.DefaultFormatter

All Implemented Interfaces:

Serializable， Cloneable

已知直接子类：

InternationalFormatter， MaskFormatter

public class DefaultFormatter
extends JFormattedTextField.AbstractFormatter
implements Cloneable, Serializable

DefaultFormatter格式的任意对象。格式是通过调用 toString方法做。为了将值转换为字符串，您的类必须提供一个需要字符串参数的构造函数。如果没有参数的构造函数，以一个字符串，返回值将被传递到 stringToValue

实例DefaultFormatter不能用于JFormattedTextField多实例。获得一份已配置的DefaultFormatter，使用clone方法。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

字符串。

从以下版本开始：

一点四

另请参见：

JFormattedTextField.AbstractFormatter

构造方法摘要

构造方法

Constructor and Description
DefaultFormatter() 创建一个defaultformatter。

方法摘要

Modifier and Type	Method and Description
Object	clone() 创建一个副本的defaultformatter。
boolean	getAllowsInvalid() 返回是否允许编辑的值是无效的一段时间。
boolean	getCommitsOnValidEdit() 返回时编辑出版回到 JFormattedTextField。
protected DocumentFilter	getDocumentFilter() 返回用于限制可以输入到 JFormattedTextField人物 DocumentFilter。
protected NavigationFilter	getNavigationFilter() 返回 NavigationFilter用来限制光标所在的位置可以放置。
boolean	getOverwriteMode() 返回插入字符时的行为。
类<?>	getValueClass() 返回用于创建新对象的类。
void	install(JFormattedTextField ftf) 安装在一个特定的 JFormattedTextField DefaultFormatter。
void	setAllowsInvalid(boolean allowsInvalid) 设置是否正在编辑的允许值是无效的时间长度（即 stringToValue抛出一个 ParseException）。
void	setCommitsOnValidEdit(boolean commit) 设置当编辑出版的回 JFormattedTextField。
void	setOverwriteMode(boolean overwriteMode) 配置的行为时，插入字符。
void	setValueClass(类<?> valueClass) 设置用于创建新对象的类。
Object	stringToValue(String string) 将传入的字符串到 getValueClass实例的方式，接受一个字符串参数的构造函数。
String	valueToString(Object value) 将传入的对象为通过 toString方法字符串。

Methods inherited from class javax.swing.JFormattedTextField.AbstractFormatter

getActions, getFormattedTextField, invalidEdit, setEditValid, uninstall

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultFormatter

public DefaultFormatter()

创建一个defaultformatter。

方法详细信息

install

public void install(JFormattedTextField ftf)

安装 DefaultFormatter在一个特定的 JFormattedTextField。这将调用 valueToString转换电流值从 JFormattedTextField为字符串。这将从 getActions安装 Actions，回来的 DocumentFilter getDocumentFilter和 NavigationFilter返回 getNavigationFilter到 JFormattedTextField

子类通常只需要重写这个如果他们希望在JFormattedTextField安装额外的听众。

如果在转换电流值为字符串的一ParseException，这将文本设置为空字符串，并标记JFormattedTextField处于无效状态。

虽然这是一个公共方法，这通常是唯一有用的JFormattedTextField subclassers。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。

结果

如果每一个有效的编辑后提交，则是正确的

setOverwriteMode

public void setOverwriteMode(boolean overwriteMode)

配置的行为时，插入字符。如果 overwriteMode是真实的（默认），新字符覆盖现有的人物模型。

参数

overwriteMode -表示如果重写或改写模式应用

getOverwriteMode

public boolean getOverwriteMode()

返回插入字符时的行为。

结果

如果新插入的字符覆盖已存在的字符，则是真的

setAllowsInvalid

public void setAllowsInvalid(boolean allowsInvalid)

设置是否正在编辑的允许值是无效的时间长度（即 stringToValue抛出一个 ParseException）。它往往是方便的，允许用户暂时输入一个无效值。

参数

allowsInvalid -用于表示如果编辑的值必须是有效的

getAllowsInvalid

public boolean getAllowsInvalid()

返回是否允许编辑的值是无效的一段时间。

结果

错误的，如果编辑的值必须始终有效

setValueClass

public void setValueClass(类<?> valueClass)

设置用于创建新对象的类。如果在类中的传递没有一个带字符串的单参数构造函数，则将使用字符串值。

参数

valueClass -用于构建stringtovalue返回值类

getValueClass

public 类<?> getValueClass()

返回用于创建新对象的类。

结果

类用于构建stringtovalue返回值

stringToValue

public Object stringToValue(String string)
                     throws ParseException

将传入的字符串到 getValueClass实例的方式，接受一个字符串参数的构造函数。如果 getValueClass返回null，该电流值在 JFormattedTextField类将使用。如果这是空的，字符串将被返回。如果构造函数抛出异常时，会抛出一个 ParseException。如果没有一个单一的参数字符串的构造函数， string将返回。

Specified by:

stringToValue 方法重写，继承类 JFormattedTextField.AbstractFormatter

参数

string字符串转换

结果

文本的对象表示

异常

ParseException -如果在转换中出现了一个错误

valueToString

public String valueToString(Object value)
                     throws ParseException

将传入的对象为通过 toString方法字符串。

Specified by:

valueToString 方法重写，继承类 JFormattedTextField.AbstractFormatter

参数

value价值转换

结果

值的字符串表示

异常

ParseException -如果在转换中出现了一个错误

getDocumentFilter

protected DocumentFilter getDocumentFilter()

返回用于限制可以输入到 JFormattedTextField人物 DocumentFilter。

重写：

getDocumentFilter 方法重写，继承类 JFormattedTextField.AbstractFormatter

结果

documentfilter限制编辑

getNavigationFilter

protected NavigationFilter getNavigationFilter()

返回 NavigationFilter用来限制光标所在的位置可以放置。

重写：

getNavigationFilter 方法重写，继承类 JFormattedTextField.AbstractFormatter

结果

navigationfilter限制导航

clone

public Object clone()
             throws CloneNotSupportedException

创建一个副本的defaultformatter。

重写：

clone 方法重写，继承类 JFormattedTextField.AbstractFormatter

结果

DefaultFormatter的复制

异常

CloneNotSupportedException -如果对象的类不支持 Cloneable接口。子类重写 clone方法也抛出该异常表示实例无法克隆。

另请参见：

Cloneable