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()为false，这将要求Format格式化每个编辑的当前文本。

您可以通过setMinimum和setMaximum方法指定最小值和最大值。 为了使这项工作中的值返回stringToValue必须与通过的方式，最小值/最大值Comparable接口。

请注意如何配置Format和InternationalFormatter ，因为可以创建无法输入某些值的情况。 考虑日期格式“M / D / Y-Y”，一个InternationalFormatter ，始终是有效的（ setAllowsInvalid(false) ），是在覆盖模式（ setOverwriteMode(true) ）和日期99年7月1日。 在这种情况下，用户将无法输入两位数字的月份或月份。 为避免这种情况，格式应为“MM / dd / yy”。

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

InternationalFormatter的行为为stringToValue与stringToValue略有DefaultTextFormatter ，它执行以下操作：

1. parseObject被Format指定的setFormat
2. 如果已经为值设置了一个Class（ setValueClass ），那么将调用parseObject实现来将从parseObject返回的值转换为适当的类。
3. 如果一个ParseException没有抛出，并且该值超出了最小/最大值，则抛出一个ParseException 。
4. 返回值。

InternationalFormatter以这种方式实现stringToValue ，这样就可以指定一个替代Class，比Format可能返回。

警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4开始，支持所有JavaBeans的长期存储已被添加到java.beans包中。 请参阅XMLEncoder 。

从以下版本开始：

1.4

另请参见：

Format ， Comparable

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	Method and Description
Object	clone() 创建一个DefaultFormatter的副本。
protected Action[]	getActions() 如果 getSupportsIncrement返回true，则返回两个适用于递增/递减值的动作。
Format.Field[]	getFields(int offset) 返回与 Format.Field的文本相关联的 offset 。
Format	getFormat() 返回指定可编辑和显示的合法值的格式。
Comparable	getMaximum() 返回最大允许值。
Comparable	getMinimum() 返回最小允许值。
void	install(JFormattedTextField ftf) 将 DefaultFormatter安装到特定的 JFormattedTextField 。
void	setFormat(Format format) 设置指定可编辑和显示的合法值的格式。
void	setMaximum(Comparable max) 设置最大允许值。
void	setMinimum(Comparable minimum) 设置最小允许值。
Object	stringToValue(String text) 返回 Object的 String text 。
String	valueToString(Object value) 返回Object value的String表示 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

构造方法详细信息

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为非null，则valueClass将被设置为该类的minimum 。

参数

minimum - 可输入的最低法定价值

另请参见：

DefaultFormatter.setValueClass(java.lang.Class<?>)

getMinimum

public Comparable getMinimum()

返回最小允许值。

结果

可输入的最低法定价值

setMaximum

public void setMaximum(Comparable max)

设置最大允许值。 如果valueClass尚未指定，并max为非null，则valueClass将被设置为该类的max 。

参数

max - 可以输入的最大合法值

另请参见：

DefaultFormatter.setValueClass(java.lang.Class<?>)

getMaximum

public Comparable getMaximum()

返回最大允许值。

结果

可输入的最大合法值

install

public void install(JFormattedTextField ftf)

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

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

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

虽然这是一种公共方法，但这通常仅适用于JFormattedTextField的JFormattedTextField 。 JFormattedTextField将在值更改或其内部状态更改的适当时候调用此方法。

重写：

install在 DefaultFormatter

参数

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

valueToString

public String valueToString(Object value)
                     throws ParseException

返回Object value的String表示value 。 这将调用format对当前Format 。

重写：

valueToString在类 DefaultFormatter

参数

value - 要转换的值

结果

值的字符串表示

异常

ParseException - 如果转换中有错误

stringToValue

public Object stringToValue(String text)
                     throws ParseException

返回 Object text的 String text 。

重写：

stringToValue在 DefaultFormatter

参数

text - String转换

结果

Object表示文字

异常

ParseException - 如果转换中有错误

getFields

public Format.Field[] getFields(int offset)

返回与Format.Field的文本相关联的offset 。 如果offset不是当前文本中的有效位置，这将返回一个空数组。

参数

offset - 偏移到要检查的文本

结果

Format.Field常量与给定位置处的文本相关联。

clone

public Object clone()
             throws CloneNotSupportedException

创建一个DefaultFormatter的副本。

重写：

clone在 DefaultFormatter

结果

DefaultFormatter的副本

异常

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

另请参见：

Cloneable

getActions

protected Action[] getActions()

如果 getSupportsIncrement返回true，则返回两个适用于递增/递减值的动作。

重写：

getActions在 JFormattedTextField.AbstractFormatter类

结果

要在JFormattedTextField上安装的操作数组