- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- javax.swing.text.JTextComponent
-
- javax.swing.JTextField
-
- javax.swing.JFormattedTextField
-
- All Implemented Interfaces:
ImageObserver,MenuContainer,Serializable,Accessible,Scrollable,SwingConstants
@JavaBean public class JFormattedTextField extends JTextField
JFormattedTextFieldextendsJTextFieldadding support for formatting arbitrary values, as well as retrieving a particular object once the user has edited the text. The following illustrates configuring aJFormattedTextFieldto edit dates:JFormattedTextField ftf = new JFormattedTextField(); ftf.setValue(new Date());
Once a
JFormattedTextFieldhas been created, you can listen for editing changes by way of adding aPropertyChangeListenerand listening forPropertyChangeEvents with the property namevalue.JFormattedTextFieldallows configuring what action should be taken when focus is lost. The possible configurations are:
The default isPossible JFormattedTextField configurations and their descriptions Value Description JFormattedTextField.REVERT Revert the display to match that of getValue, possibly losing the current edit.JFormattedTextField.COMMIT Commits the current value. If the value being edited isn't considered a legal value by the AbstractFormatterthat is, aParseExceptionis thrown, then the value will not change, and then edited value will persist.JFormattedTextField.COMMIT_OR_REVERT Similar to COMMIT, but if the value isn't legal, behave likeREVERT.JFormattedTextField.PERSIST Do nothing, don't obtain a new AbstractFormatter, and don't update the value.JFormattedTextField.COMMIT_OR_REVERT, refer tosetFocusLostBehavior(int)for more information on this.JFormattedTextFieldallows the focus to leave, even if the currently edited value is invalid. To lock the focus down while theJFormattedTextFieldis an invalid edit state you can attach anInputVerifier. The following code snippet shows a potential implementation of such anInputVerifier:public class FormattedTextFieldVerifier extends InputVerifier { public boolean verify(JComponent input) { if (input instanceof JFormattedTextField) { JFormattedTextField ftf = (JFormattedTextField)input; AbstractFormatter formatter = ftf.getFormatter(); if (formatter != null) { String text = ftf.getText(); try { formatter.stringToValue(text); return true; } catch (ParseException pe) { return false; } } } return true; } public boolean shouldYieldFocus(JComponent input) { return verify(input); } }Alternatively, you could invoke
commitEdit, which would also commit the value.JFormattedTextFielddoes not do the formatting it self, rather formatting is done through an instance ofJFormattedTextField.AbstractFormatterwhich is obtained from an instance ofJFormattedTextField.AbstractFormatterFactory. Instances ofJFormattedTextField.AbstractFormatterare notified when they become active by way of theinstallmethod, at which point theJFormattedTextField.AbstractFormattercan install whatever it needs to, typically aDocumentFilter. Similarly whenJFormattedTextFieldno longer needs theAbstractFormatter, it will invokeuninstall.JFormattedTextFieldtypically queries theAbstractFormatterFactoryfor anAbstractFormatwhen it gains or loses focus. Although this can change based on the focus lost policy. If the focus lost policy isJFormattedTextField.PERSISTand theJFormattedTextFieldhas been edited, theAbstractFormatterFactorywill not be queried until the value has been committed. Similarly if the focus lost policy isJFormattedTextField.COMMITand an exception is thrown fromstringToValue, theAbstractFormatterFactorywill not be queried when focus is lost or gained.JFormattedTextField.AbstractFormatteris also responsible for determining when values are committed to theJFormattedTextField. SomeJFormattedTextField.AbstractFormatters will make new values available on every edit, and others will never commit the value. You can force the current value to be obtained from the currentJFormattedTextField.AbstractFormatterby way of invokingcommitEdit.commitEditwill be invoked whenever return is pressed in theJFormattedTextField.If an
AbstractFormatterFactoryhas not been explicitly set, one will be set based on theClassof the value type aftersetValuehas been invoked (assuming value is non-null). For example, in the following code an appropriateAbstractFormatterFactoryandAbstractFormatterwill be created to handle formatting of numbers:JFormattedTextField tf = new JFormattedTextField(); tf.setValue(100);
Warning: As the
AbstractFormatterwill typically install aDocumentFilteron theDocument, and aNavigationFilteron theJFormattedTextFieldyou should not install your own. If you do, you are likely to see odd behavior in that the editing policy of theAbstractFormatterwill not be enforced.Warning: Swing is not thread safe. For more information see Swing's Threading Policy.
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 JavaBeans™ has been added to the
java.beanspackage. Please seeXMLEncoder.- Since:
- 1.4
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classJFormattedTextField.AbstractFormatterInstances ofAbstractFormatterare used byJFormattedTextFieldto handle the conversion both from an Object to a String, and back from a String to an Object.static classJFormattedTextField.AbstractFormatterFactoryInstances ofAbstractFormatterFactoryare used byJFormattedTextFieldto obtain instances ofAbstractFormatterwhich in turn are used to format values.-
Nested classes/interfaces declared in class javax.swing.JTextField
JTextField.AccessibleJTextField
-
Nested classes/interfaces declared in class javax.swing.text.JTextComponent
JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding
-
Nested classes/interfaces declared in class javax.swing.JComponent
JComponent.AccessibleJComponent
-
Nested classes/interfaces declared in class java.awt.Container
Container.AccessibleAWTContainer
-
Nested classes/interfaces declared in class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
-
Field Summary
Fields Modifier and Type Field Description static intCOMMITConstant identifying that when focus is lost,commitEditshould be invoked.static intCOMMIT_OR_REVERTConstant identifying that when focus is lost,commitEditshould be invoked.static intPERSISTConstant identifying that when focus is lost, the edited value should be left.static intREVERTConstant identifying that when focus is lost, editing value should be reverted to current value set on theJFormattedTextField.-
Fields declared in class javax.swing.JTextField
notifyAction
-
Fields declared in class javax.swing.text.JTextComponent
DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY
-
Fields declared in class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
-
Fields declared in class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Fields declared in interface javax.swing.SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
-
-
Constructor Summary
Constructors Constructor Description JFormattedTextField()Creates aJFormattedTextFieldwith noAbstractFormatterFactory.JFormattedTextField(Object value)Creates a JFormattedTextField with the specified value.JFormattedTextField(Format format)Creates aJFormattedTextField.JFormattedTextField(JFormattedTextField.AbstractFormatter formatter)Creates aJFormattedTextFieldwith the specifiedAbstractFormatter.JFormattedTextField(JFormattedTextField.AbstractFormatterFactory factory)Creates aJFormattedTextFieldwith the specifiedAbstractFormatterFactory.JFormattedTextField(JFormattedTextField.AbstractFormatterFactory factory, Object currentValue)Creates aJFormattedTextFieldwith the specifiedAbstractFormatterFactoryand initial value.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidcommitEdit()Forces the current value to be taken from theAbstractFormatterand set as the current value.Action[]getActions()Fetches the command list for the editor.intgetFocusLostBehavior()Returns the behavior when focus is lost.JFormattedTextField.AbstractFormattergetFormatter()Returns theAbstractFormatterthat is used to format and parse the current value.JFormattedTextField.AbstractFormatterFactorygetFormatterFactory()Returns the currentAbstractFormatterFactory.StringgetUIClassID()Gets the class ID for a UI.ObjectgetValue()Returns the last valid value.protected voidinvalidEdit()Invoked when the user inputs an invalid value.booleanisEditValid()Returns true if the current value being edited is valid.protected voidprocessFocusEvent(FocusEvent e)Processes any focus events, such asFocusEvent.FOCUS_GAINEDorFocusEvent.FOCUS_LOST.protected voidprocessInputMethodEvent(InputMethodEvent e)Processes any input method events, such asInputMethodEvent.INPUT_METHOD_TEXT_CHANGEDorInputMethodEvent.CARET_POSITION_CHANGED.voidsetDocument(Document doc)Associates the editor with a text document.voidsetFocusLostBehavior(int behavior)Sets the behavior when focus is lost.protected voidsetFormatter(JFormattedTextField.AbstractFormatter format)Sets the currentAbstractFormatter.voidsetFormatterFactory(JFormattedTextField.AbstractFormatterFactory tf)Sets theAbstractFormatterFactory.voidsetValue(Object value)Sets the value that will be formatted by anAbstractFormatterobtained from the currentAbstractFormatterFactory.-
Methods declared in class javax.swing.JTextField
actionPropertyChanged, addActionListener, configurePropertiesFromAction, createActionPropertyChangeListener, createDefaultModel, fireActionPerformed, getAccessibleContext, getAction, getActionListeners, getColumns, getColumnWidth, getHorizontalAlignment, getHorizontalVisibility, getPreferredSize, getScrollOffset, isValidateRoot, paramString, postActionEvent, removeActionListener, scrollRectToVisible, setAction, setActionCommand, setColumns, setFont, setHorizontalAlignment, setScrollOffset
-
Methods declared in class javax.swing.text.JTextComponent
addCaretListener, addKeymap, copy, cut, fireCaretUpdate, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, modelToView2D, moveCaretPosition, paste, print, print, print, read, removeCaretListener, removeKeymap, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, updateUI, viewToModel, viewToModel2D, write
-
Methods declared in class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
-
Methods declared in class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
-
Methods declared in class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
-
-
-
Field Detail
-
COMMIT
public static final int COMMIT
Constant identifying that when focus is lost,commitEditshould be invoked. If in committing the new value aParseExceptionis thrown, the invalid value will remain.- See Also:
setFocusLostBehavior(int), Constant Field Values
-
COMMIT_OR_REVERT
public static final int COMMIT_OR_REVERT
Constant identifying that when focus is lost,commitEditshould be invoked. If in committing the new value aParseExceptionis thrown, the value will be reverted.- See Also:
setFocusLostBehavior(int), Constant Field Values
-
REVERT
public static final int REVERT
Constant identifying that when focus is lost, editing value should be reverted to current value set on theJFormattedTextField.- See Also:
setFocusLostBehavior(int), Constant Field Values
-
PERSIST
public static final int PERSIST
Constant identifying that when focus is lost, the edited value should be left.- See Also:
setFocusLostBehavior(int), Constant Field Values
-
-
Constructor Detail
-
JFormattedTextField
public JFormattedTextField()
Creates aJFormattedTextFieldwith noAbstractFormatterFactory. UsesetMaskorsetFormatterFactoryto configure theJFormattedTextFieldto edit a particular type of value.
-
JFormattedTextField
public JFormattedTextField(Object value)
Creates a JFormattedTextField with the specified value. This will create anAbstractFormatterFactorybased on the type ofvalue.- Parameters:
value- Initial value for the JFormattedTextField
-
JFormattedTextField
public JFormattedTextField(Format format)
Creates aJFormattedTextField.formatis wrapped in an appropriateAbstractFormatterwhich is then wrapped in anAbstractFormatterFactory.- Parameters:
format- Format used to look up an AbstractFormatter
-
JFormattedTextField
public JFormattedTextField(JFormattedTextField.AbstractFormatter formatter)
Creates aJFormattedTextFieldwith the specifiedAbstractFormatter. TheAbstractFormatteris placed in anAbstractFormatterFactory.- Parameters:
formatter- AbstractFormatter to use for formatting.
-
JFormattedTextField
public JFormattedTextField(JFormattedTextField.AbstractFormatterFactory factory)
Creates aJFormattedTextFieldwith the specifiedAbstractFormatterFactory.- Parameters:
factory- AbstractFormatterFactory used for formatting.
-
JFormattedTextField
public JFormattedTextField(JFormattedTextField.AbstractFormatterFactory factory, Object currentValue)
Creates aJFormattedTextFieldwith the specifiedAbstractFormatterFactoryand initial value.- Parameters:
factory-AbstractFormatterFactoryused for formatting.currentValue- Initial value to use
-
-
Method Detail
-
setFocusLostBehavior
@BeanProperty(bound=false, enumerationValues={"JFormattedTextField.COMMIT","JFormattedTextField.COMMIT_OR_REVERT","JFormattedTextField.REVERT","JFormattedTextField.PERSIST"}, description="Behavior when component loses focus") public void setFocusLostBehavior(int behavior)
Sets the behavior when focus is lost. This will be one ofJFormattedTextField.COMMIT_OR_REVERT,JFormattedTextField.REVERT,JFormattedTextField.COMMITorJFormattedTextField.PERSISTNote that someAbstractFormatters may push changes as they occur, so that the value of this will have no effect.This will throw an
IllegalArgumentExceptionif the object passed in is not one of the afore mentioned values.The default value of this property is
JFormattedTextField.COMMIT_OR_REVERT.- Parameters:
behavior- Identifies behavior when focus is lost- Throws:
IllegalArgumentException- if behavior is not one of the known values
-
getFocusLostBehavior
public int getFocusLostBehavior()
Returns the behavior when focus is lost. This will be one ofCOMMIT_OR_REVERT,COMMIT,REVERTorPERSISTNote that someAbstractFormatters may push changes as they occur, so that the value of this will have no effect.- Returns:
- returns behavior when focus is lost
-
setFormatterFactory
@BeanProperty(visualUpdate=true, description="AbstractFormatterFactory, responsible for returning an AbstractFormatter that can format the current value.") public void setFormatterFactory(JFormattedTextField.AbstractFormatterFactory tf)
Sets theAbstractFormatterFactory.AbstractFormatterFactoryis able to return an instance ofAbstractFormatterthat is used to format a value for display, as well an enforcing an editing policy.If you have not explicitly set an
AbstractFormatterFactoryby way of this method (or a constructor) anAbstractFormatterFactoryand consequently anAbstractFormatterwill be used based on theClassof the value.NumberFormatterwill be used forNumbers,DateFormatterwill be used forDates, otherwiseDefaultFormatterwill be used.This is a JavaBeans bound property.
- Parameters:
tf-AbstractFormatterFactoryused to lookup instances ofAbstractFormatter
-
getFormatterFactory
public JFormattedTextField.AbstractFormatterFactory getFormatterFactory()
Returns the currentAbstractFormatterFactory.- Returns:
AbstractFormatterFactoryused to determineAbstractFormatters- See Also:
setFormatterFactory(javax.swing.JFormattedTextField.AbstractFormatterFactory)
-
setFormatter
protected void setFormatter(JFormattedTextField.AbstractFormatter format)
Sets the currentAbstractFormatter.You should not normally invoke this, instead set the
AbstractFormatterFactoryor set the value.JFormattedTextFieldwill invoke this as the state of theJFormattedTextFieldchanges and requires the value to be reset.JFormattedTextFieldpasses in theAbstractFormatterobtained from theAbstractFormatterFactory.This is a JavaBeans bound property.
- Parameters:
format- AbstractFormatter to use for formatting- See Also:
setFormatterFactory(javax.swing.JFormattedTextField.AbstractFormatterFactory)
-
getFormatter
@BeanProperty(visualUpdate=true, description="TextFormatter, responsible for formatting the current value") public JFormattedTextField.AbstractFormatter getFormatter()
Returns theAbstractFormatterthat is used to format and parse the current value.- Returns:
- AbstractFormatter used for formatting
-
setValue
@BeanProperty(visualUpdate=true, description="The value to be formatted.") public void setValue(Object value)
Sets the value that will be formatted by anAbstractFormatterobtained from the currentAbstractFormatterFactory. If noAbstractFormatterFactoryhas been specified, this will attempt to create one based on the type ofvalue.The default value of this property is null.
This is a JavaBeans bound property.
- Parameters:
value- Current value to display
-
getValue
public Object getValue()
Returns the last valid value. Based on the editing policy of theAbstractFormatterthis may not return the current value. The currently edited value can be obtained by invokingcommitEditfollowed bygetValue.- Returns:
- Last valid value
-
commitEdit
public void commitEdit() throws ParseExceptionForces the current value to be taken from theAbstractFormatterand set as the current value. This has no effect if there is no currentAbstractFormatterinstalled.- Throws:
ParseException- if theAbstractFormatteris not able to format the current value
-
isEditValid
@BeanProperty(bound=false) public boolean isEditValid()
Returns true if the current value being edited is valid. The value of this is managed by the currentAbstractFormatter, as such there is no public setter for it.- Returns:
- true if the current value being edited is valid.
-
invalidEdit
protected void invalidEdit()
Invoked when the user inputs an invalid value. This gives the component a chance to provide feedback. The default implementation beeps.
-
processInputMethodEvent
protected void processInputMethodEvent(InputMethodEvent e)
Processes any input method events, such asInputMethodEvent.INPUT_METHOD_TEXT_CHANGEDorInputMethodEvent.CARET_POSITION_CHANGED.- Overrides:
processInputMethodEventin classComponent- Parameters:
e- theInputMethodEvent- See Also:
InputMethodEvent
-
processFocusEvent
protected void processFocusEvent(FocusEvent e)
Processes any focus events, such asFocusEvent.FOCUS_GAINEDorFocusEvent.FOCUS_LOST.- Overrides:
processFocusEventin classComponent- Parameters:
e- theFocusEvent- See Also:
FocusEvent
-
getActions
@BeanProperty(bound=false) public Action[] getActions()
Fetches the command list for the editor. This is the list of commands supported by the plugged-in UI augmented by the collection of commands that the editor itself supports. These are useful for binding to events, such as in a keymap.- Overrides:
getActionsin classJTextField- Returns:
- the command list
-
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
Gets the class ID for a UI.- Overrides:
getUIClassIDin classJTextField- Returns:
- the string "FormattedTextFieldUI"
- See Also:
JComponent.getUIClassID()
-
setDocument
@BeanProperty(expert=true, description="the text document model") public void setDocument(Document doc)
Associates the editor with a text document. The currently registered factory is used to build a view for the document, which gets displayed by the editor after revalidation. A PropertyChange event ("document") is propagated to each listener.- Overrides:
setDocumentin classJTextField- Parameters:
doc- the document to display/edit- See Also:
JTextComponent.getDocument()
-
-