javax.swing

Class JFormattedTextField.AbstractFormatter

java.lang.Object

javax.swing.JFormattedTextField.AbstractFormatter

All Implemented Interfaces:

Serializable

已知直接子类：

DefaultFormatter

Enclosing class:

JFormattedTextField

public abstract static class JFormattedTextField.AbstractFormatter
extends Object
implements Serializable

AbstractFormatter的AbstractFormatter由JFormattedTextField用于处理从对象到字符串以及从字符串返回到对象的转换。 AbstractFormatter还可以强制执行编辑策略或导航策略，或以任何方式JFormattedTextField以执行所需策略。

一个AbstractFormatter只能在一个JFormattedTextField一次有效。 JFormattedTextField调用install当它准备好使用它后跟uninstall完成。 希望安装其他状态的子类应该覆盖install和超级消息。

子类必须覆盖转换方法stringToValue和valueToString 。 可选他们可以覆盖getActions ， getNavigationFilter和getDocumentFilter限制JFormattedTextField以特定的方式。

允许JFormattedTextField处于暂时无效状态的子类应在适当的时候调用setEditValid 。

从以下版本开始：

1.4

构造方法摘要

构造方法

Constructor and Description
AbstractFormatter()

方法摘要

Modifier and Type	Method and Description
protected Object	clone() 克隆 AbstractFormatter 。
protected Action[]	getActions() 子类和覆盖，如果你想提供一个定制的 Action s。
protected DocumentFilter	getDocumentFilter() 如果您希望提供 DocumentFilter以限制可以输入的内容，则可以使用子类和覆盖。
protected JFormattedTextField	getFormattedTextField() 返回当前 JFormattedTextField的 AbstractFormatter 。
protected NavigationFilter	getNavigationFilter() 如果您希望提供一个过滤器来限制用户可以导航的位置，则可以使用子类和覆盖。
void	install(JFormattedTextField ftf) 将 AbstractFormatter安装到特定的 JFormattedTextField 。
protected void	invalidEdit() 当用户键入无效字符时，应该调用此值。
protected void	setEditValid(boolean valid) 调用此更新 editValid的财产 JFormattedTextField 。
abstract Object	stringToValue(String text) 解析 text返回任意的对象。
void	uninstall() 卸载任何状态 AbstractFormatter可能对安装 JFormattedTextField 。
abstract String	valueToString(Object value) 返回 value显示的字符串值。

Methods inherited from class java.lang.Object

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

构造方法详细信息

AbstractFormatter

public AbstractFormatter()

方法详细信息

install

public void install(JFormattedTextField ftf)

安装AbstractFormatter到特定JFormattedTextField 。 这将调用valueToString将当前值从JFormattedTextField转换为字符串。 那么这将安装Action从s getActions ，该DocumentFilter从返回getDocumentFilter和NavigationFilter从返回getNavigationFilter到JFormattedTextField 。

子类通常只需要覆盖这个，如果他们希望在JFormattedTextField上安装其他监听JFormattedTextField 。

如果有一个ParseException将当前值转换为字符串，则将文本设置为空字符串，并将JFormattedTextField标记为无效状态。

虽然这是一种公共方法，但这通常仅适用于JFormattedTextField的JFormattedTextField 。 JFormattedTextField将在值更改或其内部状态更改的适当时候调用此方法。 您只需要将此调用自己，如果你正在继承JFormattedTextField和安装/卸载AbstractFormatter比不同的时间JFormattedTextField做。

参数

ftf - JFormattedTextField格式化，可能为null表示从当前JFormattedTextField卸载。

uninstall

public void uninstall()

卸载任何状态AbstractFormatter可能对安装JFormattedTextField 。 这将重置DocumentFilter ， NavigationFilter和附加Action安装在S JFormattedTextField 。

stringToValue

public abstract Object stringToValue(String text)
                              throws ParseException

解析text返回任意对象。 一些格式化程序可能返回null。

参数

text - 要转换的字符串

结果

文本的对象表示

异常

ParseException - 转换中是否有错误

valueToString

public abstract String valueToString(Object value)
                              throws ParseException

返回 value显示的字符串值。

参数

value - 要转换的价值

结果

值的字符串表示

异常

ParseException - 如果转换中有错误

getFormattedTextField

protected JFormattedTextField getFormattedTextField()

返回当前 JFormattedTextField的 AbstractFormatter 。

结果

JFormattedTextField格式化。

invalidEdit

protected void invalidEdit()

当用户键入无效字符时，应该调用此值。 这会将调用转发到当前的JFormattedTextField。

setEditValid

protected void setEditValid(boolean valid)

调用此更新editValid的财产JFormattedTextField 。 如果您强制执行JFormattedTextField始终处于有效状态的策略，则您将永远不需要调用此策略。

参数

valid - valid有效状态

getActions

protected Action[] getActions()

子类和覆盖，如果你想提供一个自定义的Action s。 install将安装在JFormattedTextField的ActionMap 。

结果

要在JFormattedTextField上安装的操作数组

getDocumentFilter

protected DocumentFilter getDocumentFilter()

子类和覆盖，如果你想提供一个DocumentFilter来限制可以输入的内容。 install将返回的值安装到JFormattedTextField 。

结果

DocumentFilter来限制编辑

getNavigationFilter

protected NavigationFilter getNavigationFilter()

如果您希望提供一个过滤器来限制用户可以导航的位置，则可以使用子类和覆盖。 install将返回的值安装到JFormattedTextField 。

结果

NavigationFilter限制导航

clone

protected Object clone()
                throws CloneNotSupportedException

克隆AbstractFormatter 。 返回的实例不与JFormattedTextField 。

重写：

clone在 Object

结果

AbstractFormatter的副本

异常

CloneNotSupportedException - 如果对象的类不支持Cloneable接口。 覆盖clone方法的子类也可以引发此异常以指示实例无法克隆。

另请参见：

Cloneable