- java.lang.Object
-
- javax.swing.JFormattedTextField.AbstractFormatter
-
- javax.swing.text.DefaultFormatter
-
- 实现的所有接口
-
Serializable
,Cloneable
- 已知直接子类:
-
InternationalFormatter
,MaskFormatter
public class DefaultFormatter extends JFormattedTextField.AbstractFormatter implements Cloneable, Serializable
DefaultFormatter
格式化任意对象。 通过调用toString
方法完成格式化。 为了将值转换回String,您的类必须提供一个带String参数的构造函数。 如果找不到带有String的单个参数构造函数,则返回的值将是传递给stringToValue
的String。实例
DefaultFormatter
不能在JFormattedTextField
多个实例中JFormattedTextField
。 要获取已配置的DefaultFormatter
的副本,请使用clone
方法。警告:此类的序列化对象与以后的Swing版本不兼容。 当前的序列化支持适用于运行相同版本Swing的应用程序之间的短期存储或RMI。 从1.4开始,
java.beans
软件包中添加了对所有JavaBeansjava.beans
长期存储的支持。 请参阅XMLEncoder
。- 从以下版本开始:
- 1.4
- 另请参见:
-
JFormattedTextField.AbstractFormatter
, Serialized Form
-
-
构造方法摘要
构造方法 构造器 描述 DefaultFormatter()
创建DefaultFormatter。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 Object
clone()
创建DefaultFormatter的副本。boolean
getAllowsInvalid()
返回被编辑的值是否允许在一段时间内无效。boolean
getCommitsOnValidEdit()
编辑返回到JFormattedTextField
时返回。protected DocumentFilter
getDocumentFilter()
返回DocumentFilter
用于限制,可以是输入到字符JFormattedTextField
。protected NavigationFilter
getNavigationFilter()
返回用于限制光标放置位置的NavigationFilter
。boolean
getOverwriteMode()
返回插入字符时的行为。类<?>
getValueClass()
返回用于创建新对象的类。void
install(JFormattedTextField ftf)
将DefaultFormatter
安装到特定的JFormattedTextField
。void
setAllowsInvalid(boolean allowsInvalid)
设置是否允许正在编辑的值在一段时间内无效(即stringToValue
抛出ParseException
)。void
setCommitsOnValidEdit(boolean commit)
设置何时将编辑内容发布回JFormattedTextField
。void
setOverwriteMode(boolean overwriteMode)
配置插入字符时的行为。void
setValueClass(类<?> valueClass)
设置用于创建新对象的类。Object
stringToValue(String string)
通过带有String参数的构造函数将传入的String转换为getValueClass
的实例。String
valueToString(Object value)
通过toString
方法将传入的Object转换为String。-
声明方法的类 javax.swing.JFormattedTextField.AbstractFormatter
getActions, getFormattedTextField, invalidEdit, setEditValid, uninstall
-
-
-
-
方法详细信息
-
install
public void install(JFormattedTextField ftf)
将DefaultFormatter
安装到特定的JFormattedTextField
。 这将调用valueToString
将当前值从JFormattedTextField
转换为String。 那么这将安装Action
从sgetActions
,该DocumentFilter
从返回getDocumentFilter
和NavigationFilter
从返回getNavigationFilter
至JFormattedTextField
。如果子类希望在
JFormattedTextField
上安装其他侦听器,则通常只需要覆盖它。如果在将当前值转换为String时存在
ParseException
,则会将文本设置为空字符串,并将JFormattedTextField
标记为处于无效状态。虽然这是一种公共方法,但这通常仅适用于
JFormattedTextField
子类。JFormattedTextField
将在值更改或其内部状态更改的适当时间调用此方法。- 重写:
-
install
在类JFormattedTextField.AbstractFormatter
- 参数
-
ftf
- 要格式化的JFormattedTextField,可以为null,表示从当前JFormattedTextField卸载。
-
setCommitsOnValidEdit
public void setCommitsOnValidEdit(boolean commit)
设置何时将编辑内容发布回JFormattedTextField
。 如果为true,则在每次有效编辑后调用commitEdit
(任何时候编辑文本)。 另一方面,如果这是假的,则DefaultFormatter
不会将编辑发布回JFormattedTextField
。 因此,JFormattedTextField
的值将更改的唯一时间是在commitEdit
上调用JFormattedTextField
,通常在按下enter或焦点离开JFormattedTextField
。- 参数
-
commit
- 用于指示何时将编辑提交回JTextComponent
-
getCommitsOnValidEdit
public boolean getCommitsOnValidEdit()
将编辑内容发布回JFormattedTextField
时返回。- 结果
- 如果在每次有效编辑后提交编辑,则为true
-
setOverwriteMode
public void setOverwriteMode(boolean overwriteMode)
配置插入字符时的行为。 如果overwriteMode
为true(默认值),则新字符将覆盖模型中的现有字符。- 参数
-
overwriteMode
- 指示是否使用覆盖或重写模式
-
getOverwriteMode
public boolean getOverwriteMode()
返回插入字符时的行为。- 结果
- 如果新插入的字符覆盖现有字符,则为true
-
setAllowsInvalid
public void setAllowsInvalid(boolean allowsInvalid)
设置被编辑的值是否允许在一段时间内无效(即stringToValue
抛出ParseException
)。 允许用户临时输入无效值通常很方便。- 参数
-
allowsInvalid
- 用于指示编辑的值是否必须始终有效
-
getAllowsInvalid
public boolean getAllowsInvalid()
返回被编辑的值是否允许在一段时间内无效。- 结果
- 如果编辑的值必须始终有效,则为false
-
setValueClass
public void setValueClass(类<?> valueClass)
设置用于创建新对象的类。 如果传入的类没有带有String的单个参数构造函数,则将使用String值。- 参数
-
valueClass
- 用于从stringToValue构造返回值的类
-
getValueClass
public 类<?> getValueClass()
返回用于创建新对象的类。- 结果
- 用于从stringToValue构造返回值的类
-
stringToValue
public Object stringToValue(String string) throws ParseException
通过带有String参数的构造函数将传入的String转换为getValueClass
的实例。 如果getValueClass
返回null,则将使用JFormattedTextField
当前值的Class。 如果为null,则返回String。 如果构造函数抛出异常,则抛出ParseException
。 如果没有单个参数String构造函数,则将返回string
。- Specified by:
-
stringToValue
类JFormattedTextField.AbstractFormatter
- 参数
-
string
- 要转换的字符串 - 结果
- 文本的对象表示
- 异常
-
ParseException
- 如果转换中存在错误
-
valueToString
public String valueToString(Object value) throws ParseException
通过toString
方法将传入的Object转换为String。- Specified by:
-
valueToString
在课程JFormattedTextField.AbstractFormatter
- 参数
-
value
- 要转换的值 - 结果
- 字符串表示的值
- 异常
-
ParseException
- 如果转换中存在错误
-
getDocumentFilter
protected DocumentFilter getDocumentFilter()
返回DocumentFilter
用于限制,可以是输入到字符JFormattedTextField
。- 重写:
-
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
-
-