|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.swing.JFormattedTextField.AbstractFormatter javax.swing.text.DefaultFormatter
DefaultFormatter
formats aribtrary objects. Formatting is done
by invoking the toString
method. In order to convert the
value back to a String, your class must provide a constructor that
takes a String argument. If no single argument constructor that takes a
String is found, the returned value will be the String passed into
stringToValue
.
Instances of DefaultFormatter
can not be used in multiple
instances of JFormattedTextField
. To obtain a copy of
an already configured DefaultFormatter
, use the
clone
method.
Warning:
Serialized objects of this class will not be compatible with
future Swing releases. The current serialization support is
appropriate for short term storage or RMI between applications running
the same version of Swing. As of 1.4, support for long term storage
of all JavaBeansTM
has been added to the java.beans
package.
Please see XMLEncoder
.
JFormattedTextField.AbstractFormatter
,
Serialized FormNested Class Summary | |
private class |
DefaultFormatter.DefaultDocumentFilter
DocumentFilter implementation that calls back to the replace method of DefaultFormatter. |
private class |
DefaultFormatter.DefaultNavigationFilter
NavigationFilter implementation that calls back to methods with same name in DefaultFormatter. |
(package private) static class |
DefaultFormatter.ReplaceHolder
ReplaceHolder is used to track where insert/remove/replace is going to happen. |
Field Summary | |
private boolean |
allowsInvalid
Indicates if the value being edited must match the mask. |
private boolean |
commitOnEdit
If true, any time a valid edit happens commitEdit is invoked. |
private DocumentFilter |
documentFilter
DocumentFilter that forwards calls back to DefaultFormatter. |
private NavigationFilter |
navigationFilter
NavigationFilter that forwards calls back to DefaultFormatter. |
private boolean |
overwriteMode
If true, editing mode is in overwrite (or strikethough). |
(package private) DefaultFormatter.ReplaceHolder |
replaceHolder
Used during replace to track the region to replace. |
private Class |
valueClass
Class used to create new instances. |
Fields inherited from class javax.swing.JFormattedTextField.AbstractFormatter |
|
Constructor Summary | |
DefaultFormatter()
Creates a DefaultFormatter. |
Method Summary | |
(package private) boolean |
canReplace(DefaultFormatter.ReplaceHolder rh)
Returns true if the edit described by rh will result
in a legal value. |
Object |
clone()
Creates a copy of the DefaultFormatter. |
(package private) void |
commitEdit()
Invokes commitEdit on the JFormattedTextField. |
boolean |
getAllowsInvalid()
Returns whether or not the value being edited is allowed to be invalid for a length of time. |
boolean |
getCommitsOnValidEdit()
Returns when edits are published back to the JFormattedTextField . |
protected DocumentFilter |
getDocumentFilter()
Returns the DocumentFilter used to restrict the characters
that can be input into the JFormattedTextField . |
(package private) int |
getInitialVisualPosition()
Returns the initial location to position the cursor at. |
protected NavigationFilter |
getNavigationFilter()
Returns the NavigationFilter used to restrict where the
cursor can be placed.
|
(package private) int |
getNextCursorPosition(int offset,
int direction)
Returns the next cursor position from offset by incrementing direction . |
private int |
getNextNavigatableChar(int offset,
int direction)
Returns the next editable character starting at offset incrementing the offset by direction . |
(package private) int |
getNextVisualPositionFrom(JTextComponent text,
int pos,
Position.Bias bias,
int direction,
Position.Bias[] biasRet)
Finds the next navigatable character. |
boolean |
getOverwriteMode()
Returns the behavior when inserting characters. |
(package private) DefaultFormatter.ReplaceHolder |
getReplaceHolder(DocumentFilter.FilterBypass fb,
int offset,
int length,
String text,
AttributeSet attrs)
Returns the ReplaceHolder to track the replace of the specified text. |
(package private) String |
getReplaceString(int offset,
int deleteLength,
String replaceString)
A convenience methods to return the result of deleting deleteLength characters at offset
and inserting replaceString at offset
in the current text field. |
Class |
getValueClass()
Returns that class that is used to create new Objects. |
void |
install(JFormattedTextField ftf)
Installs the DefaultFormatter onto a particular
JFormattedTextField .
|
(package private) boolean |
isLegalInsertText(String text)
Returns true if the text in text can be inserted. |
(package private) boolean |
isNavigatable(int offset)
Subclasses should override this if they want cursor navigation to skip certain characters. |
(package private) boolean |
isValidEdit(DefaultFormatter.ReplaceHolder rh)
|
(package private) void |
moveDot(NavigationFilter.FilterBypass fb,
int dot,
Position.Bias bias)
NavigationFilter method, subclasses that wish finer control should override this. |
(package private) void |
positionCursorAtInitialLocation()
Positions the cursor at the initial location. |
(package private) boolean |
replace(DefaultFormatter.ReplaceHolder rh)
If the edit described by rh is legal, this will
return true, commit the edit (if necessary) and update the cursor
position. |
(package private) void |
replace(DocumentFilter.FilterBypass fb,
int offset,
int length,
String text,
AttributeSet attrs)
DocumentFilter method, funnels into replace . |
(package private) void |
repositionCursor(int offset,
int direction)
Resets the cursor by using getNextCursorPosition. |
void |
setAllowsInvalid(boolean allowsInvalid)
Sets whether or not the value being edited is allowed to be invalid for a length of time (that is, stringToValue throws
a ParseException ).
|
void |
setCommitsOnValidEdit(boolean commit)
Sets when edits are published back to the JFormattedTextField . |
(package private) void |
setDot(NavigationFilter.FilterBypass fb,
int dot,
Position.Bias bias)
NavigationFilter method, subclasses that wish finer control should override this. |
void |
setOverwriteMode(boolean overwriteMode)
Configures the behavior when inserting characters. |
void |
setValueClass(Class valueClass)
Sets that class that is used to create new Objects. |
Object |
stringToValue(String string)
Converts the passed in String into an instance of getValueClass by way of the constructor that
takes a String argument. |
(package private) void |
updateValue()
Pushes the value to the JFormattedTextField if the current value is valid and invokes setEditValid based on the
validity of the value. |
(package private) void |
updateValue(Object value)
Pushes the value to the editor if we are to
commit on edits. |
String |
valueToString(Object value)
Converts the passed in Object into a String by way of the toString method. |
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 |
Field Detail |
private boolean allowsInvalid
private boolean overwriteMode
private boolean commitOnEdit
private Class valueClass
private NavigationFilter navigationFilter
private DocumentFilter documentFilter
transient DefaultFormatter.ReplaceHolder replaceHolder
Constructor Detail |
public DefaultFormatter()
Method Detail |
public void install(JFormattedTextField ftf)
DefaultFormatter
onto a particular
JFormattedTextField
.
This will invoke valueToString
to convert the
current value from the JFormattedTextField
to
a String. This will then install the Action
s from
getActions
, the DocumentFilter
returned from getDocumentFilter
and the
NavigationFilter
returned from
getNavigationFilter
onto the
JFormattedTextField
.
Subclasses will typically only need to override this if they
wish to install additional listeners on the
JFormattedTextField
.
If there is a ParseException
in converting the
current value to a String, this will set the text to an empty
String, and mark the JFormattedTextField
as being
in an invalid state.
While this is a public method, this is typically only useful
for subclassers of JFormattedTextField
.
JFormattedTextField
will invoke this method at
the appropriate times when the value changes, or its internal
state changes.
install
in class JFormattedTextField.AbstractFormatter
ftf
- JFormattedTextField to format for, may be null indicating
uninstall from current JFormattedTextField.public void setCommitsOnValidEdit(boolean commit)
JFormattedTextField
. If true, commitEdit
is invoked after every valid edit (any time the text is edited). On
the other hand, if this is false than the DefaultFormatter
does not publish edits back to the JFormattedTextField
.
As such, the only time the value of the JFormattedTextField
will change is when commitEdit
is invoked on
JFormattedTextField
, typically when enter is pressed
or focus leaves the JFormattedTextField
.
commit
- Used to indicate when edits are commited back to the
JTextComponentpublic boolean getCommitsOnValidEdit()
JFormattedTextField
.
public void setOverwriteMode(boolean overwriteMode)
overwriteMode
is true (the default), new characters
overwrite existing characters in the model.
overwriteMode
- Indicates if overwrite or overstrike mode is usedpublic boolean getOverwriteMode()
public void setAllowsInvalid(boolean allowsInvalid)
stringToValue
throws
a ParseException
).
It is often convenient to allow the user to temporarily input an
invalid value.
allowsInvalid
- Used to indicate if the edited value must always
be validpublic boolean getAllowsInvalid()
public void setValueClass(Class valueClass)
valueClass
- Class used to construct return value from
stringToValuepublic Class getValueClass()
public Object stringToValue(String string) throws ParseException
getValueClass
by way of the constructor that
takes a String argument. If getValueClass
returns null, the Class of the current value in the
JFormattedTextField
will be used. If this is null, a
String will be returned. If the constructor thows an exception, a
ParseException
will be thrown. If there is no single
argument String constructor, string
will be returned.
stringToValue
in class JFormattedTextField.AbstractFormatter
string
- String to convert
ParseException
- if there is an error in the conversionpublic String valueToString(Object value) throws ParseException
toString
method.
valueToString
in class JFormattedTextField.AbstractFormatter
value
- Value to convert
ParseException
- if there is an error in the conversionprotected DocumentFilter getDocumentFilter()
DocumentFilter
used to restrict the characters
that can be input into the JFormattedTextField
.
getDocumentFilter
in class JFormattedTextField.AbstractFormatter
protected NavigationFilter getNavigationFilter()
NavigationFilter
used to restrict where the
cursor can be placed.
characters that can be input into the JFormattedTextField
.
getNavigationFilter
in class JFormattedTextField.AbstractFormatter
public Object clone() throws CloneNotSupportedException
clone
in class JFormattedTextField.AbstractFormatter
CloneNotSupportedException
void positionCursorAtInitialLocation()
int getInitialVisualPosition()
getNextNavigatableChar
.
boolean isNavigatable(int offset)
offset
should be skipped when
navigating throught the field.
boolean isLegalInsertText(String text)
text
can be inserted. This
does not mean the text will ultimately be inserted, it is used if
text can trivially reject certain characters.
private int getNextNavigatableChar(int offset, int direction)
direction
.
String getReplaceString(int offset, int deleteLength, String replaceString)
deleteLength
characters at offset
and inserting replaceString
at offset
in the current text field.
boolean isValidEdit(DefaultFormatter.ReplaceHolder rh)
void commitEdit() throws ParseException
commitEdit
on the JFormattedTextField.
ParseException
void updateValue()
setEditValid
based on the
validity of the value.
void updateValue(Object value)
value
to the editor if we are to
commit on edits. If value
is null, the current value
will be obtained from the text component.
int getNextCursorPosition(int offset, int direction)
direction
. This uses
getNextNavigatableChar
as well as constraining the location to the max position.
void repositionCursor(int offset, int direction)
int getNextVisualPositionFrom(JTextComponent text, int pos, Position.Bias bias, int direction, Position.Bias[] biasRet) throws BadLocationException
BadLocationException
boolean canReplace(DefaultFormatter.ReplaceHolder rh)
rh
will result
in a legal value.
void replace(DocumentFilter.FilterBypass fb, int offset, int length, String text, AttributeSet attrs) throws BadLocationException
replace
.
BadLocationException
boolean replace(DefaultFormatter.ReplaceHolder rh) throws BadLocationException
rh
is legal, this will
return true, commit the edit (if necessary) and update the cursor
position. This forwards to canReplace
and
isLegalInsertText
as necessary to determine if
the edit is in fact legal.
All of the DocumentFilter methods funnel into here, you should generally only have to override this.
BadLocationException
void setDot(NavigationFilter.FilterBypass fb, int dot, Position.Bias bias)
void moveDot(NavigationFilter.FilterBypass fb, int dot, Position.Bias bias)
DefaultFormatter.ReplaceHolder getReplaceHolder(DocumentFilter.FilterBypass fb, int offset, int length, String text, AttributeSet attrs)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |