javax.swing.text

Class InternationalFormatter

java.lang.Object

javax.swing.JFormattedTextField.AbstractFormatter

javax.swing.text.DefaultFormatter

javax.swing.text.InternationalFormatter

All Implemented Interfaces:

Serializable， Cloneable

已知直接子类：

DateFormatter， NumberFormatter

public class InternationalFormatter
extends DefaultFormatter

InternationalFormatter延伸 DefaultFormatter，利用 java.text.Format实例来处理转换为一个字符串，字符串的转换。

如果getAllowsInvalid()是虚假的，这就要求Format当前文本格式在每个编辑。

你可以指定一个最小的setMinimum和setMaximum方法最大值。为了解决这个返回值从stringToValue必须通过Comparable接口可与最小/最大值。

小心你如何配置Format和InternationalFormatter，尽可能创造一种环境，一定不能输入值。考虑到日期格式的M / D /日”，一个InternationalFormatter总是有效的（setAllowsInvalid(false)），在覆盖模式（setOverwriteMode(true)）和日期7 / 1 / 99。在这种情况下，用户将无法进入一二位数的月或月的一天。为了避免这种情况，格式为“年/月/日”。

如果InternationalFormatter配置为只允许有效值（setAllowsInvalid(false)），每一个有效的编辑将导致的JFormattedTextField完全复位的Format文本。光标的位置也会随着文字的添加和删除从得到的字符串调整。

对stringToValue InternationalFormatter的行为比DefaultTextFormatter略有不同，它的下面：

1. parseObject是指定的setFormat的Format调用
2. 如果一个类被设置为值（setValueClass）、超级执行调用的返回值parseObject转换到相应的类。
3. 如果一个ParseException尚未抛出，和值在最小/最大一ParseException抛出。
4. 返回值。

InternationalFormatter实现 stringToValue以这种方式，你可以指定一个类比 Format可能返回。

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

从以下版本开始：

一点四

另请参见：

Format， Comparable

构造方法摘要

构造方法

Constructor and Description
InternationalFormatter() 创建一个没有 Format指定 InternationalFormatter。
InternationalFormatter(Format format) 创建具有指定 Format实例 InternationalFormatter。

方法摘要

Modifier and Type	Method and Description
Object	clone() 创建一个副本的defaultformatter。
protected Action[]	getActions() 如果 getSupportsIncrement返回真，返回两个动作适合递增/递减价值。
Format.Field[]	getFields(int offset) 返回在 offset文本相关的 Format.Field常数。
Format	getFormat() 返回指定可以编辑和显示的合法值的格式。
Comparable	getMaximum() 返回最大允许值。
Comparable	getMinimum() 返回最小允许值。
void	install(JFormattedTextField ftf) 安装在一个特定的 JFormattedTextField DefaultFormatter。
void	setFormat(Format format) 设置决定可以编辑和显示的法律价值的格式。
void	setMaximum(Comparable max) 设置最大允许值。
void	setMinimum(Comparable minimum) 设置最小允许值。
Object	stringToValue(String text) 返回的 String text的 Object表示。
String	valueToString(Object value) 返回该对象的字符串表示形式 value。

Methods inherited from class javax.swing.text.DefaultFormatter

getAllowsInvalid, getCommitsOnValidEdit, getDocumentFilter, getNavigationFilter, getOverwriteMode, getValueClass, setAllowsInvalid, setCommitsOnValidEdit, setOverwriteMode, setValueClass

Methods inherited from class javax.swing.JFormattedTextField.AbstractFormatter

getFormattedTextField, invalidEdit, setEditValid, uninstall

Methods inherited from class java.lang.Object

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

Constructor Detail

InternationalFormatter

public InternationalFormatter()

创建一个没有 Format指定 InternationalFormatter。

InternationalFormatter

public InternationalFormatter(Format format)

创建具有指定 Format实例 InternationalFormatter。

参数

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()

返回最大允许值。

结果

可以输入的最大的法律价值

install

public void install(JFormattedTextField ftf)

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

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

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

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

返回的 String text的 Object表示。

重写：

stringToValue 方法重写，继承类 DefaultFormatter

参数

text - String转换

结果

文本 Object表示

异常

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

getFields

public Format.Field[] getFields(int offset)

返回在 offset文本相关的 Format.Field常数。如果 offset不是有效的定位到当前文本，这将返回一个空数组。

参数

offset偏移成文本进行检查

结果

与给定位置的文本关联的字段常量。

clone

public Object clone()
             throws CloneNotSupportedException

创建一个副本的defaultformatter。

重写：

clone 方法重写，继承类 DefaultFormatter

结果

DefaultFormatter的复制

异常

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

另请参见：

Cloneable

getActions

protected Action[] getActions()

如果 getSupportsIncrement返回真，返回两个动作适合递增/递减价值。

重写：

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

结果

行动jformattedtextfield阵列安装