AbstractFormField (Tentackle Swing 8.2.3.0 API)

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.text.JTextComponent
      - javax.swing.JTextField
        
        org.tentackle.swing.AbstractFormField

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable, SwingConstants, FormChangeable, FormChangeableComponent, FormComponent, FormFieldComponent

Direct Known Subclasses:

AbstractNumberFormField, DateFormField, StringFormField
```
public abstract class AbstractFormField
extends JTextField
implements FormFieldComponent
```
Abstract base class for all text fields.
All Tentackle beans providing a single-line text field bean subclass the AbstractFormField class which implements FormFieldComponent. FormFields provide a lot of features essential for typical business applications, such as data binding.

Author:

harald

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class javax.swing.JTextField
  JTextField.AccessibleJTextField
- Nested classes/interfaces inherited from class javax.swing.text.JTextComponent
  JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding
- Nested classes/interfaces inherited from class javax.swing.JComponent
  JComponent.AccessibleJComponent
- Nested classes/interfaces inherited from class java.awt.Container
  Container.AccessibleAWTContainer
- Nested classes/interfaces inherited from class java.awt.Component
  Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`protected String`	`errorMessage` the error message corresponding to errorOffset
`protected int`	`errorOffset` caret position for (first) error, -1 if no error
`protected String`	`savedValue` last savepoint

Fields inherited from class javax.swing.JTextField
notifyAction

Fields inherited from class javax.swing.text.JTextComponent
DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface org.tentackle.swing.FormFieldComponent
ADJUST_LEFT, ADJUST_NONE, ADJUST_RIGHT, ADJUST_TRIM, CONVERT_LC, CONVERT_NONE, CONVERT_UC

Fields inherited from 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

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors
Constructor and Description
`AbstractFormField()` Creates an empty AbstractFormField with the default document model, and minimum column width.
`AbstractFormField(Document doc, String str, int columns)` Creates a AbstractFormField. Notice: setting doc != null requires a doc derived from FormFieldDocument.
`AbstractFormField(int columns)` Creates a AbstractFormField with the default document model and given column width.
`AbstractFormField(String str)` Creates a AbstractFormField with the default document model, minimum width and given initial text.
`AbstractFormField(String str, int columns)` Creates a AbstractFormField with the default document model.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addValueListener(ValueListener listener)` Adds a value listener that implements the binding between this component and the data.
`void`	`clearText()` Clears the contents of this component.
`void`	`clearValueShownModified()` Clears the value shown status. May be used by components that update the value shown programmatically.
`protected Document`	`createDefaultModel()`
`void`	`downRight()` Move the caret to the right side of field and if already there move to next field.
`void`	`fireValueChanged()` Fires all value listeners registered on this component invoking their `valueChanged`-handler. This method is invoked whenever the data has been changed and that change should be reflected in the view.
`void`	`fireValueEntered()` Fires all listeners registered on this component invoking their `valueEntered`-handler. This method is invoked whenever the user edited the view and that change should be reflected in the data.
`char`	`getAdjust()` Gets the current adjustment.
`FormComponentBinding`	`getBinding()` Gets the binding.
`String`	`getBindingPath()` Gets the binding path.
`String`	`getComponentPath()` Gets the component path.
`char`	`getConvert()` Gets the current convesion
`Function<String,String>`	`getConverter()` Gets the current converter.
`int`	`getDefaultColumns()` Gets the default columns.
`String`	`getErrorMessage()` Gets the parsing error message for the first error.
`int`	`getErrorOffset()` Gets the offset in this components text for the first parsing error.
`char`	`getFiller()` Gets the current fill char.
`FocusTraversalGroup`	`getFocusTraversalGroup()` Gets the focus traversal group for this component.
`String`	`getHelpURL()` Gets the online-help URL.
`String`	`getInvalidChars()` Gets invalid characters.
`int`	`getMaxColumns()` Gets the maximum number of columns.
`Window`	`getParentWindow()` Gets the parent window of this component.
`Dimension`	`getPreferredSize()`
`PropertyGroup`	`getPropertyGroup()` Gets the property group for this component.
`String`	`getText()` Gets the text from the view of this component.
`String`	`getToolTipText()` Gets the tooltip text for this component.
`String`	`getValidChars()` Gets allowed characters.
`String`	`getValueShown()` Gets the value shown to the user. This is the visual representation, not necessarily the model's value.
`int`	`getVerticalAlignment()` Gets the vertical alignment.
`protected void`	`hideErrorPopup()` Removes any error popup.
`void`	`invalidateParentInfo()` Invalidates all container-relevant (cached) information for the hierarchy of this component's parents. For optimization purposes.
`boolean`	`isAutoNext()` Returns whether the auto-next feature is enabled.
`boolean`	`isAutoSelect()` Returns whether the auto-select feature is enabled.
`boolean`	`isAutoUpdate()` Returns whether the auto-update feature is enabled.
`boolean`	`isBindable()` Determines whether this component is bindable.
`boolean`	`isCaretLeft()` Returns whether carat is at leftmost position.
`boolean`	`isCaretRight()` Returns whether caret is at rightmost position.
`boolean`	`isCellEditorUsage()` Returns whether this component is used as a cell editor.
`boolean`	`isChangeable()` Returns if this component is changeable.
`boolean`	`isEmpty()` Determines whether this component is empty.
`boolean`	`isEraseFirst()` Returns whether to erase the field after first setText().
`boolean`	`isFireRunning()` Checks whether a fire-method is running.
`boolean`	`isFormTraversable()` Returns whether this component is form traversable or not.
`boolean`	`isHonourChangeable()` Returns whether this component should honour the changeable-attribute or not.
`boolean`	`isInhibitAutoSelect()` Returns whether auto-select is inhibited (once).
`boolean`	`isMandatory()` Gets the mandatory option.
`boolean`	`isOverwrite()` Gets the current override mode.
`boolean`	`isSmartValueEntered()` Returns whether the model should only be updated if the component's value really changed. The default is true.
`boolean`	`isStartEditLeftmost()` Returns whether to start edit leftmost in this component (once).
`boolean`	`isTriggerValueChangedEnabled()` Determines whether triggering value changes is enabled.
`boolean`	`isValueChanged()` Checks whether the contents have been changed since the last savepoint.
`boolean`	`isValueShownModified()` Checks whether the currently shown value differs from the initially shown. Used to implement smartValueEntered.
`void`	`prepareFocusLost()` Prepares for FOCUS_LOST. Gives this component the opportunity to invoke fireValueEntered() earlier than FOCUS_LOST is really received.
`protected void`	`processFocusEvent(FocusEvent e)`
`protected boolean`	`processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)`
`void`	`removeValueListener(ValueListener listener)` Remove a value listener.
`void`	`requestFocusLater()` Requests the keyboard focus for this component by appending an event to the end of the event queue. Applications should not use requestFocus() or requestFocusInWindow() unless the order in which the events are processed is unimportant.
`protected void`	`restoreSavedValue()` Restores the previously saved value. Method is provided to be overridden by `AbstractNumberFormField`.
`void`	`saveValue()` Sets a savepoint for the data of this component. Allows to decide whether the user has changed the data associated with this component or not.
`void`	`setAdjust(char adjust)` Sets character adjustment. By default the text input data is trimmed, i.e.
`void`	`setAutoNext(boolean autonext)` Sets the auto-next feature. If autonext is enabled the next component will automatically receive the focus if the maximum number of characters is reached.
`void`	`setAutoSelect(boolean autoselect)` Sets the auto-select feature. A component with autoselect enabled will automatically select all characters if the component gets the keyboard focus.
`void`	`setAutoUpdate(boolean autoupdate)` Sets the auto-update feature. By default, all components update the data model if the view changes (due to certain events, for example focus lost).
`void`	`setBindable(boolean bindable)` Sets whether this component is bindable.
`void`	`setBinding(FormComponentBinding binding)` Sets the binding.
`void`	`setBindingPath(String bindingPath)` Sets the path to bind this component to.
`void`	`setCaretLeft()` Sets the caret to leftmost position.
`void`	`setCaretRight()` Sets the caret to rightmost position.
`void`	`setCellEditorUsage(boolean flag)` Sets a hint that this component is used as a cell editor. Some components behave differently in tables than in forms, for example.
`void`	`setChangeable(boolean changeable)` Set the component to be changeable. This is a unified abstraction and will be translated to setEditable or setEnabled, whatever is appropriate to this component.
`void`	`setColumns(int columns)` Sets the number of columns in this component. The visible width is adjusted according to the current font.
`void`	`setComponentPath(String componentPath)` Sets the component path.
`void`	`setConvert(char convert)` Sets character upper/lowercase conversion. Notice that changing the character conversion will immediately convert.
`void`	`setConverter(Function<String,String> converter)` Sets the string converter. Besides the lower/uppercase conversion an optional converter may be set to translate characters.
`void`	`setDefaultColumns(int defaultColumns)` Sets the default columns. The method is mainly provided for GUI-designers and will change the displayed size if, and only if, setColumns() and setMaxColumns() has not been invoked yet.
`void`	`setEditable(boolean editable)`
`void`	`setEraseFirst(boolean erasefirst)` Sets whether to erase the field after first setText().
`void`	`setErrorMessage(String errorMessage)` Sets the error message.
`void`	`setErrorOffset(int errorOffset)` Sets the error offset.
`void`	`setFiller(char filler)` Sets the fill char. The fill char determines the adjustment of the text data.
`void`	`setFireRunning(boolean running)` Sets a component's flag that a fire-method is currently running. Used by the framework to minimize valueChanged/valueEntered processing.
`void`	`setFocusTraversalGroup(FocusTraversalGroup group)` Sets the focus traversal group for this component.
`void`	`setFormTraversable(boolean formTraversable)` Sets whether this component is form traversable or not, i.e.
`void`	`setFormWrapWindow(FormWindow parent)` Sets the window that will fire a `FormWrapEvent` when this components loses the keyboard focus.
`void`	`setHelpURL(String helpURL)` Sets the online-help URL. If a help url is set for this component, a browser will be launched to show that url.
`void`	`setHonourChangeable(boolean flag)` Sets whether this component should honour the changeable-attribute or not. The default is true.
`void`	`setInhibitAutoSelect(boolean inhibitAutoSelect)` Sets auto-select to be inhibited inhibited (once).
`void`	`setInvalidChars(String invalidChars)` Sets invalid characters.
`void`	`setMandatory(boolean mandatory)` Sets the mandatory option. Mandatory fields are differently visualized.
`void`	`setMaxColumns(int maxColumns)` Sets the maximum number of columns. The number of columns will be enforced by the model.
`void`	`setOverwrite(boolean override)` Sets the insert/override mode.
`void`	`setPropertyGroup(PropertyGroup group)` Sets the property group for this component.
`void`	`setSmartValueEntered(boolean smartValueEntered)` Sets whether the model should only be updated if the component's value really changed. The default is true.
`void`	`setStartEditLeftmost(boolean startEditLeftmost)` Sets whether to start edit leftmost in this component (once).
`void`	`setText(String str)` Sets the given text in the view of this component.
`void`	`setTriggerValueChangedEnabled(boolean enabled)` Enables triggering value changes. Disabling this feature may be necessary for model-agnostic components.
`void`	`setValidChars(String validChars)` Sets allowed characters.
`void`	`setVerticalAlignment(int alignment)` Sets the vertical alignment. Can only be used in Tentackle-LookAndFeels!
`protected void`	`showErrorPopup()` Shows the error popup if parsing failed
`void`	`showErrorPopup(String message)` Shows the error popup for a given message. The popup component used is an `ErrorToolTip`.
`void`	`showHelp()` Displays online help for this component. Usually triggered by KeyEvent.VK_F1 or VK_HELP or a button.
`void`	`transferFocus()` Transfers keyboard focus forward to the logically next component.
`void`	`transferFocusBackward()` Transfers keyboard focus forward to the logically previous component.
`void`	`triggerValueChanged()` Promotes the fact that value changed to all `FormContainer`s this component is a child of.
`void`	`updateAllChangeable(boolean allChangeable)` Updates the container's changeable flag.
`void`	`upLeft()` Move caret to the left side of field and if already there move to previous field.
`boolean`	`wasFocusGainedFromTransfer()` Returns whether the keyboard focus was gained due to `FormComponent.transferFocus()` in the opposite component.
`boolean`	`wasFocusGainedFromTransferBackward()` Returns whether the keyboard focus was gained due to `FormComponent.transferFocusBackward()` in the opposite component.
`boolean`	`wasTransferFocus()` Returns whether this component lost the keyboard focus due to `FormComponent.transferFocus()`.
`boolean`	`wasTransferFocusBackward()` Returns whether this component lost the keyboard focus due to `FormComponent.transferFocusBackward()`.
`boolean`	`wasTransferFocusByEnter()` Returns whether this component lost the keyboard focus due to `KeyEvent.VK_ENTER`.

Methods inherited from class javax.swing.text.JTextComponent
addCaretListener, addInputMethodListener, addKeymap, copy, cut, fireCaretUpdate, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paste, print, print, print, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setDropMode, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, updateUI, viewToModel, write

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, 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 inherited from 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 inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, 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, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.tentackle.swing.FormFieldComponent
doFormat, getCaretPosition, getColumns, getFormat, getHorizontalAlignment, postActionEvent, setCaretPosition, setFormat, setHorizontalAlignment, setToolTipText

Methods inherited from interface org.tentackle.swing.FormComponent
getBaseline, getFormValue, hasFocus, setFormValue

- Field Detail
  - errorOffset
```
protected int errorOffset
```
    caret position for (first) error, -1 if no error
  - errorMessage
```
protected String errorMessage
```
    the error message corresponding to errorOffset
  - savedValue
```
protected String savedValue
```
    last savepoint
- Constructor Detail
  - AbstractFormField
```
public AbstractFormField(Document doc,
                         String str,
                         int columns)
```
    Creates a AbstractFormField.
    Notice: setting doc != null requires a doc derived from FormFieldDocument.
    
    Parameters:
    
    doc - the document model, null = default
    
    str - the initial text, null = empty
    
    columns - the number of columns, 0 = minimum width
  - AbstractFormField
```
public AbstractFormField(String str,
                         int columns)
```
    Creates a AbstractFormField with the default document model.
    
    Parameters:
    
    str - the initial text, null = empty
    
    columns - the number of columns, 0 = minimum width
  - AbstractFormField
```
public AbstractFormField(String str)
```
    Creates a AbstractFormField with the default document model, minimum width and given initial text.
    
    Parameters:
    
    str - the initial text, null = empty
  - AbstractFormField
```
public AbstractFormField(int columns)
```
    Creates a AbstractFormField with the default document model and given column width.
    
    Parameters:
    
    columns - the number of columns, 0 = minimum width
  - AbstractFormField
```
public AbstractFormField()
```
    Creates an empty AbstractFormField with the default document model, and minimum column width.
- Method Detail
  - processKeyBinding
```
protected boolean processKeyBinding(KeyStroke ks,
                                    KeyEvent e,
                                    int condition,
                                    boolean pressed)
```
    Overridden: Changes the nerving behaviour that pressing backspace at the end of a selection clears the whole selection. Especially in autoselected numeric fields its often necessary to overtype the last digits. With this hack backspace simply clears the selection.
    
    Overrides:
    
    processKeyBinding in class JComponent
  - restoreSavedValue
```
protected void restoreSavedValue()
```
    Restores the previously saved value.
    Method is provided to be overridden by AbstractNumberFormField.
  - setColumns
```
public void setColumns(int columns)
```
    Sets the number of columns in this component.
    The visible width is adjusted according to the current font.
    Overridden to inhibit excessive geometry-management (for example in Gridbaglayout).
    
    Specified by:
    
    setColumns in interface FormFieldComponent
    
    Overrides:
    
    setColumns in class JTextField
    
    Parameters:
    
    columns - the number of columns ≥ 0
  - createDefaultModel
```
protected Document createDefaultModel()
```
    Overridden to set the default FormFieldDocument.
    
    Overrides:
    
    createDefaultModel in class JTextField
  - processFocusEvent
```
protected void processFocusEvent(FocusEvent e)
```
    Overridden to perform focus handling and data binding
    
    Overrides:
    
    processFocusEvent in class Component
  - setText
```
public void setText(String str)
```
    Sets the given text in the view of this component.
    Overridden to turn off autoNext during inserts and to implement eraseFirst.
    
    Specified by:
    
    setText in interface FormFieldComponent
    
    Overrides:
    
    setText in class JTextComponent
    
    Parameters:
    
    str - the text
  - getText
```
public String getText()
```
    Gets the text from the view of this component.
    Overridden because of text adjustment.
    
    Specified by:
    
    getText in interface FormFieldComponent
    
    Overrides:
    
    getText in class JTextComponent
    
    Returns:
    
    the text
  - transferFocus
```
public void transferFocus()
```
    Transfers keyboard focus forward to the logically next component.
    Ovwerwritten to set transferFocusDone.
    
    Specified by:
    
    transferFocus in interface FormComponent
    
    Overrides:
    
    transferFocus in class Component
    
    See Also:
    
    FormFocusTraversalPolicy
  - transferFocusBackward
```
public void transferFocusBackward()
```
    Transfers keyboard focus forward to the logically previous component.
    Ovwerwritten to set transferFocusBackwardDone.
    
    Specified by:
    
    transferFocusBackward in interface FormComponent
    
    Overrides:
    
    transferFocusBackward in class Component
    
    See Also:
    
    FormFocusTraversalPolicy
  - showErrorPopup
```
public void showErrorPopup(String message)
```
    Description copied from interface: FormComponent
    
    Shows the error popup for a given message.
    The popup component used is an ErrorToolTip.
    
    Specified by:
    
    showErrorPopup in interface FormComponent
    
    Parameters:
    
    message - the message to be displayed, null to remove
  - hideErrorPopup
```
protected void hideErrorPopup()
```
    Removes any error popup.
  - showErrorPopup
```
protected void showErrorPopup()
```
    Shows the error popup if parsing failed
  - addValueListener
```
public void addValueListener(ValueListener listener)
```
    Description copied from interface: FormComponent
    
    Adds a value listener that implements the binding between this component and the data.
    
    Specified by:
    
    addValueListener in interface FormComponent
    
    Parameters:
    
    listener - the value listener to add
  - removeValueListener
```
public void removeValueListener(ValueListener listener)
```
    Description copied from interface: FormComponent
    
    Remove a value listener.
    
    Specified by:
    
    removeValueListener in interface FormComponent
    
    Parameters:
    
    listener - the value listener to remove
  - requestFocusLater
```
public void requestFocusLater()
```
    Description copied from interface: FormComponent
    
    Requests the keyboard focus for this component by appending an event to the end of the event queue.
    Applications should not use requestFocus() or requestFocusInWindow() unless the order in which the events are processed is unimportant. This method guarantees that this component gets the focus when all events queued so far have been processed.
    
    Specified by:
    
    requestFocusLater in interface FormComponent
  - fireValueChanged
```
public void fireValueChanged()
```
    Description copied from interface: FormComponent
    
    Fires all value listeners registered on this component invoking their valueChanged-handler.
    This method is invoked whenever the data has been changed and that change should be reflected in the view.
    
    Specified by:
    
    fireValueChanged in interface FormComponent
  - fireValueEntered
```
public void fireValueEntered()
```
    Description copied from interface: FormComponent
    
    Fires all listeners registered on this component invoking their valueEntered-handler.
    This method is invoked whenever the user edited the view and that change should be reflected in the data.
    
    Specified by:
    
    fireValueEntered in interface FormComponent
  - saveValue
```
public void saveValue()
```
    Description copied from interface: FormComponent
    
    Sets a savepoint for the data of this component.
    Allows to decide whether the user has changed the data associated with this component or not.
    
    Specified by:
    
    saveValue in interface FormComponent
    
    See Also:
    
    FormComponent.isValueChanged()
  - isValueChanged
```
public boolean isValueChanged()
```
    Description copied from interface: FormComponent
    
    Checks whether the contents have been changed since the last savepoint.
    
    Specified by:
    
    isValueChanged in interface FormComponent
    
    Returns:
    
    true if changed
    
    See Also:
    
    FormComponent.saveValue()
  - setTriggerValueChangedEnabled
```
public void setTriggerValueChangedEnabled(boolean enabled)
```
    Description copied from interface: FormComponent
    
    Enables triggering value changes.
    Disabling this feature may be necessary for model-agnostic components.
    
    Specified by:
    
    setTriggerValueChangedEnabled in interface FormComponent
    
    Parameters:
    
    enabled - true if invoke FormComponent.triggerValueChanged() on each change (default), false if not.
  - isTriggerValueChangedEnabled
```
public boolean isTriggerValueChangedEnabled()
```
    Description copied from interface: FormComponent
    
    Determines whether triggering value changes is enabled.
    
    Specified by:
    
    isTriggerValueChangedEnabled in interface FormComponent
    
    Returns:
    
    true if invoke FormComponent.triggerValueChanged() on each change (default), false if not.
  - triggerValueChanged
```
public void triggerValueChanged()
```
    Description copied from interface: FormComponent
    
    Promotes the fact that value changed to all FormContainers this component is a child of.
    
    Specified by:
    
    triggerValueChanged in interface FormComponent
  - setCellEditorUsage
```
public void setCellEditorUsage(boolean flag)
```
    Description copied from interface: FormComponent
    
    Sets a hint that this component is used as a cell editor.
    Some components behave differently in tables than in forms, for example.
    
    Specified by:
    
    setCellEditorUsage in interface FormComponent
    
    Parameters:
    
    flag - true if component is a cell editor, false if not.
  - isCellEditorUsage
```
public boolean isCellEditorUsage()
```
    Description copied from interface: FormComponent
    
    Returns whether this component is used as a cell editor.
    
    Specified by:
    
    isCellEditorUsage in interface FormComponent
    
    Returns:
    
    true true if component is a cell editor, false if not.
  - prepareFocusLost
```
public void prepareFocusLost()
```
    Description copied from interface: FormComponent
    
    Prepares for FOCUS_LOST.
    Gives this component the opportunity to invoke fireValueEntered() earlier than FOCUS_LOST is really received. Useful because the next focused component is determined before FOCUS_LOST is sent to this component. Thus, if this component changes the focusability of the next component, the focus policy would probably pick the wrong component otherwise.
    
    Specified by:
    
    prepareFocusLost in interface FormComponent
  - showHelp
```
public void showHelp()
```
    Description copied from interface: FormComponent
    
    Displays online help for this component.
    Usually triggered by KeyEvent.VK_F1 or VK_HELP or a button. If help is not configured for this component, the parent's help is used.
    
    Specified by:
    
    showHelp in interface FormComponent
  - clearText
```
public void clearText()
```
    Description copied from interface: FormFieldComponent
    
    Clears the contents of this component.
    
    Specified by:
    
    clearText in interface FormFieldComponent
  - isEmpty
```
public boolean isEmpty()
```
    Description copied from interface: FormFieldComponent
    
    Determines whether this component is empty.
    
    Specified by:
    
    isEmpty in interface FormFieldComponent
    
    Returns:
    
    true if empty
  - isCaretLeft
```
public boolean isCaretLeft()
```
    Description copied from interface: FormFieldComponent
    
    Returns whether carat is at leftmost position.
    
    Specified by:
    
    isCaretLeft in interface FormFieldComponent
    
    Returns:
    
    true if caret is at leftmost position
  - isCaretRight
```
public boolean isCaretRight()
```
    Description copied from interface: FormFieldComponent
    
    Returns whether caret is at rightmost position.
    
    Specified by:
    
    isCaretRight in interface FormFieldComponent
    
    Returns:
    
    true if caret is at rightmost position
  - upLeft
```
public void upLeft()
```
    Description copied from interface: FormFieldComponent
    
    Move caret to the left side of field and if already there move to previous field.
    
    Specified by:
    
    upLeft in interface FormFieldComponent
  - downRight
```
public void downRight()
```
    Description copied from interface: FormFieldComponent
    
    Move the caret to the right side of field and if already there move to next field.
    
    Specified by:
    
    downRight in interface FormFieldComponent
  - setCaretLeft
```
public void setCaretLeft()
```
    Description copied from interface: FormFieldComponent
    
    Sets the caret to leftmost position.
    
    Specified by:
    
    setCaretLeft in interface FormFieldComponent
  - setCaretRight
```
public void setCaretRight()
```
    Description copied from interface: FormFieldComponent
    
    Sets the caret to rightmost position.
    
    Specified by:
    
    setCaretRight in interface FormFieldComponent
  - setEraseFirst
```
public void setEraseFirst(boolean erasefirst)
```
    Description copied from interface: FormFieldComponent
    
    Sets whether to erase the field after first setText().
    
    Specified by:
    
    setEraseFirst in interface FormFieldComponent
    
    Parameters:
    
    erasefirst - true to clear after first setText
  - isEraseFirst
```
public boolean isEraseFirst()
```
    Description copied from interface: FormFieldComponent
    
    Returns whether to erase the field after first setText().
    
    Specified by:
    
    isEraseFirst in interface FormFieldComponent
    
    Returns:
    
    true to clear after first setText
  - setChangeable
```
public void setChangeable(boolean changeable)
```
    Description copied from interface: FormChangeable
    
    Set the component to be changeable.
    This is a unified abstraction and will be translated to setEditable or setEnabled, whatever is appropriate to this component.
    
    Specified by:
    
    setChangeable in interface FormChangeable
    
    Parameters:
    
    changeable - true the user can edit the data, false if show only
  - isChangeable
```
public boolean isChangeable()
```
    Description copied from interface: FormChangeable
    
    Returns if this component is changeable.
    
    Specified by:
    
    isChangeable in interface FormChangeable
    
    Returns:
    
    true the user can edit the data, false if show only
  - setHonourChangeable
```
public void setHonourChangeable(boolean flag)
```
    Description copied from interface: FormChangeable
    
    Sets whether this component should honour the changeable-attribute or not.
    The default is true. Notice: if this component does not honour the changeable flag, isValueChanged() always returns false and it will not perform any saveValue().
    
    Specified by:
    
    setHonourChangeable in interface FormChangeable
    
    Parameters:
    
    flag - true if honour the changeable attribute, false if not
  - isHonourChangeable
```
public boolean isHonourChangeable()
```
    Description copied from interface: FormChangeable
    
    Returns whether this component should honour the changeable-attribute or not.
    
    Specified by:
    
    isHonourChangeable in interface FormChangeable
    
    Returns:
    
    true if honour the changeable attribute, false if not
  - updateAllChangeable
```
public void updateAllChangeable(boolean allChangeable)
```
    Description copied from interface: FormChangeableComponent
    
    Updates the container's changeable flag.
    Whenever FormChangeable.setChangeable(boolean) is invoked all of the container's components get this method invoked.
    
    Specified by:
    
    updateAllChangeable in interface FormChangeableComponent
    
    Parameters:
    
    allChangeable - true if changeable
  - setEditable
```
public void setEditable(boolean editable)
```
    Overrides:
    
    setEditable in class JTextComponent
  - getDefaultColumns
```
public int getDefaultColumns()
```
    Description copied from interface: FormFieldComponent
    
    Gets the default columns.
    
    Specified by:
    
    getDefaultColumns in interface FormFieldComponent
    
    Returns:
    
    the default columns.
  - setDefaultColumns
```
public void setDefaultColumns(int defaultColumns)
```
    Description copied from interface: FormFieldComponent
    
    Sets the default columns.
    The method is mainly provided for GUI-designers and will change the displayed size if, and only if, setColumns() and setMaxColumns() has not been invoked yet. The default columns will not affect the model in any way.
    With defaultColumns it is possible to set the width of a field to a reasonable size and let the application use setMaxColumn() to set the real value from the model (which is not available at design time).
    
    Specified by:
    
    setDefaultColumns in interface FormFieldComponent
    
    Parameters:
    
    defaultColumns - the default columns
  - setMaxColumns
```
public void setMaxColumns(int maxColumns)
```
    Description copied from interface: FormFieldComponent
    
    Sets the maximum number of columns.
    The number of columns will be enforced by the model.
    If JTextField.getColumns() == 0 the component will resize as if setColumns has been invoked with the given maxColumns. However, getColumns() remains 0.
    
    Specified by:
    
    setMaxColumns in interface FormFieldComponent
    
    Parameters:
    
    maxColumns - the maximum number of columns, 0 if unlimited (default)
  - getMaxColumns
```
public int getMaxColumns()
```
    Description copied from interface: FormFieldComponent
    
    Gets the maximum number of columns.
    
    Specified by:
    
    getMaxColumns in interface FormFieldComponent
    
    Returns:
    
    the maximum number of columns, 0 if unlimited (default)
  - getPreferredSize
```
public Dimension getPreferredSize()
```
    Overrides:
    
    getPreferredSize in class JTextField
  - setConvert
```
public void setConvert(char convert)
```
    Description copied from interface: FormFieldComponent
    
    Sets character upper/lowercase conversion.
    Notice that changing the character conversion will immediately convert.
    
    Specified by:
    
    setConvert in interface FormFieldComponent
    
    Parameters:
    
    convert - one of FormField.CONVERT_...
  - getConvert
```
public char getConvert()
```
    Description copied from interface: FormFieldComponent
    
    Gets the current convesion
    
    Specified by:
    
    getConvert in interface FormFieldComponent
    
    Returns:
    
    the conversion, default is CONVERT_NONE
  - setAdjust
```
public void setAdjust(char adjust)
```
    Description copied from interface: FormFieldComponent
    
    Sets character adjustment.
    By default the text input data is trimmed, i.e. fill characters (space by default) to the left and right are removed. This is not be mixed up with the horizontal orientation!
    
    Specified by:
    
    setAdjust in interface FormFieldComponent
    
    Parameters:
    
    adjust - one of FormField.ADJUST_...
    
    See Also:
    
    FormFieldComponent.setFiller(char)
  - getAdjust
```
public char getAdjust()
```
    Description copied from interface: FormFieldComponent
    
    Gets the current adjustment.
    
    Specified by:
    
    getAdjust in interface FormFieldComponent
    
    Returns:
    
    the adjustment, default ADJUST_TRIM
  - setAutoSelect
```
public void setAutoSelect(boolean autoselect)
```
    Description copied from interface: FormFieldComponent
    
    Sets the auto-select feature.
    A component with autoselect enabled will automatically select all characters if the component gets the keyboard focus. Useful for numerical fields, for example.
    
    Specified by:
    
    setAutoSelect in interface FormFieldComponent
    
    Parameters:
    
    autoselect - true if autoselect enabled, false if disabled (default)
  - isAutoSelect
```
public boolean isAutoSelect()
```
    Description copied from interface: FormFieldComponent
    
    Returns whether the auto-select feature is enabled.
    
    Specified by:
    
    isAutoSelect in interface FormFieldComponent
    
    Returns:
    
    true if autoselect enabled, false if disabled (default)
  - setAutoNext
```
public void setAutoNext(boolean autonext)
```
    Description copied from interface: FormFieldComponent
    
    Sets the auto-next feature.
    If autonext is enabled the next component will automatically receive the focus if the maximum number of characters is reached. Only meaningful if maxColumns > 0
    
    Specified by:
    
    setAutoNext in interface FormFieldComponent
    
    Parameters:
    
    autonext - true if autonext enabled, false if disabled (default)
  - isAutoNext
```
public boolean isAutoNext()
```
    Description copied from interface: FormFieldComponent
    
    Returns whether the auto-next feature is enabled.
    
    Specified by:
    
    isAutoNext in interface FormFieldComponent
    
    Returns:
    
    true if autonext enabled, false if disabled (default)
  - setAutoUpdate
```
public void setAutoUpdate(boolean autoupdate)
```
    Description copied from interface: FormComponent
    
    Sets the auto-update feature.
    By default, all components update the data model if the view changes (due to certain events, for example focus lost).
    
    Specified by:
    
    setAutoUpdate in interface FormComponent
    
    Parameters:
    
    autoupdate - true if auto update the data (default), false if not
  - isAutoUpdate
```
public boolean isAutoUpdate()
```
    Description copied from interface: FormComponent
    
    Returns whether the auto-update feature is enabled.
    
    Specified by:
    
    isAutoUpdate in interface FormComponent
    
    Returns:
    
    true if auto update the data (default), false if not
  - setValidChars
```
public void setValidChars(String validChars)
```
    Description copied from interface: FormFieldComponent
    
    Sets allowed characters.
    
    Specified by:
    
    setValidChars in interface FormFieldComponent
    
    Parameters:
    
    validChars - the valid characters, null = all (default)
  - getValidChars
```
public String getValidChars()
```
    Description copied from interface: FormFieldComponent
    
    Gets allowed characters.
    
    Specified by:
    
    getValidChars in interface FormFieldComponent
    
    Returns:
    
    the valid characters, null = all (default)
  - setInvalidChars
```
public void setInvalidChars(String invalidChars)
```
    Description copied from interface: FormFieldComponent
    
    Sets invalid characters.
    
    Specified by:
    
    setInvalidChars in interface FormFieldComponent
    
    Parameters:
    
    invalidChars - the invalid characters, null = none (default)
  - getInvalidChars
```
public String getInvalidChars()
```
    Description copied from interface: FormFieldComponent
    
    Gets invalid characters.
    
    Specified by:
    
    getInvalidChars in interface FormFieldComponent
    
    Returns:
    
    the invalid characters, null = none (default)
  - setFiller
```
public void setFiller(char filler)
```
    Description copied from interface: FormFieldComponent
    
    Sets the fill char.
    The fill char determines the adjustment of the text data.
    
    Specified by:
    
    setFiller in interface FormFieldComponent
    
    Parameters:
    
    filler - the fill character
    
    See Also:
    
    FormFieldComponent.setAdjust(char)
  - getFiller
```
public char getFiller()
```
    Description copied from interface: FormFieldComponent
    
    Gets the current fill char.
    
    Specified by:
    
    getFiller in interface FormFieldComponent
    
    Returns:
    
    the filler, default is blank (space)
  - setOverwrite
```
public void setOverwrite(boolean override)
```
    Description copied from interface: FormFieldComponent
    
    Sets the insert/override mode.
    
    Specified by:
    
    setOverwrite in interface FormFieldComponent
    
    Parameters:
    
    override - true if override, false if insert (default)
  - isOverwrite
```
public boolean isOverwrite()
```
    Description copied from interface: FormFieldComponent
    
    Gets the current override mode.
    
    Specified by:
    
    isOverwrite in interface FormFieldComponent
    
    Returns:
    
    true if override, false if insert (default)
  - setStartEditLeftmost
```
public void setStartEditLeftmost(boolean startEditLeftmost)
```
    Description copied from interface: FormFieldComponent
    
    Sets whether to start edit leftmost in this component (once).
    
    Specified by:
    
    setStartEditLeftmost in interface FormFieldComponent
    
    Parameters:
    
    startEditLeftmost - true if start edit leftmost
  - isStartEditLeftmost
```
public boolean isStartEditLeftmost()
```
    Description copied from interface: FormFieldComponent
    
    Returns whether to start edit leftmost in this component (once).
    
    Specified by:
    
    isStartEditLeftmost in interface FormFieldComponent
    
    Returns:
    
    true if start edit leftmost
  - getErrorOffset
```
public int getErrorOffset()
```
    Description copied from interface: FormFieldComponent
    
    Gets the offset in this components text for the first parsing error.
    
    Specified by:
    
    getErrorOffset in interface FormFieldComponent
    
    Returns:
    
    the error offset, -1 if no error
  - setErrorOffset
```
public void setErrorOffset(int errorOffset)
```
    Description copied from interface: FormFieldComponent
    
    Sets the error offset.
    
    Specified by:
    
    setErrorOffset in interface FormFieldComponent
    
    Parameters:
    
    errorOffset - the error offset in the text component, -1 to clear
  - getErrorMessage
```
public String getErrorMessage()
```
    Description copied from interface: FormFieldComponent
    
    Gets the parsing error message for the first error.
    
    Specified by:
    
    getErrorMessage in interface FormFieldComponent
    
    Returns:
    
    the error message (may be null)
  - setErrorMessage
```
public void setErrorMessage(String errorMessage)
```
    Description copied from interface: FormFieldComponent
    
    Sets the error message.
    
    Specified by:
    
    setErrorMessage in interface FormFieldComponent
    
    Parameters:
    
    errorMessage - the message, null to clear
  - setFireRunning
```
public void setFireRunning(boolean running)
```
    Description copied from interface: FormComponent
    
    Sets a component's flag that a fire-method is currently running.
    Used by the framework to minimize valueChanged/valueEntered processing.
    
    Specified by:
    
    setFireRunning in interface FormComponent
    
    Parameters:
    
    running - true if some fire-method is running
  - isFireRunning
```
public boolean isFireRunning()
```
    Description copied from interface: FormComponent
    
    Checks whether a fire-method is running.
    
    Specified by:
    
    isFireRunning in interface FormComponent
    
    Returns:
    
    true if some fire-method is running
  - isInhibitAutoSelect
```
public boolean isInhibitAutoSelect()
```
    Description copied from interface: FormFieldComponent
    
    Returns whether auto-select is inhibited (once).
    
    Specified by:
    
    isInhibitAutoSelect in interface FormFieldComponent
    
    Returns:
    
    true if inhibited
  - setInhibitAutoSelect
```
public void setInhibitAutoSelect(boolean inhibitAutoSelect)
```
    Sets auto-select to be inhibited inhibited (once).
    When set inhibits autoSelect once after having performed eraseFirst. This is necessary for components in a JTable because after pressing a key eraseFirst will be executed, then the key inserted and THEN the field gets the focusGained which will selectAll if autoSelect enabled. The eraseFirst is triggered in FormFieldComponentCellEditor. This flag is really package internal!
    
    Specified by:
    
    setInhibitAutoSelect in interface FormFieldComponent
    
    Parameters:
    
    inhibitAutoSelect - true if inhibited
  - setFormWrapWindow
```
public void setFormWrapWindow(FormWindow parent)
```
    Description copied from interface: FormComponent
    
    Sets the window that will fire a FormWrapEvent when this components loses the keyboard focus. When fired the reference to the window is cleared.
    
    Specified by:
    
    setFormWrapWindow in interface FormComponent
    
    Parameters:
    
    parent - the window (usually the parent window of this component).
  - setVerticalAlignment
```
public void setVerticalAlignment(int alignment)
```
    Description copied from interface: FormFieldComponent
    
    Sets the vertical alignment.
    Can only be used in Tentackle-LookAndFeels!
    
    Specified by:
    
    setVerticalAlignment in interface FormFieldComponent
    
    Parameters:
    
    alignment - the vertical alignment
  - getVerticalAlignment
```
public int getVerticalAlignment()
```
    Description copied from interface: FormFieldComponent
    
    Gets the vertical alignment.
    
    Specified by:
    
    getVerticalAlignment in interface FormFieldComponent
    
    Returns:
    
    the vertical alignment
  - getHelpURL
```
public String getHelpURL()
```
    Description copied from interface: FormComponent
    
    Gets the online-help URL.
    
    Specified by:
    
    getHelpURL in interface FormComponent
    
    Returns:
    
    the help url, default is null
  - setHelpURL
```
public void setHelpURL(String helpURL)
```
    Description copied from interface: FormComponent
    
    Sets the online-help URL.
    If a help url is set for this component, a browser will be launched to show that url. If there is no url the next higher level container will determine the url, and so forth.
    
    Specified by:
    
    setHelpURL in interface FormComponent
    
    Parameters:
    
    helpURL - the help url
    
    See Also:
    
    FormUtilities.openHelpURL(Component)
  - getConverter
```
public Function<String,String> getConverter()
```
    Description copied from interface: FormFieldComponent
    
    Gets the current converter. Default is null.
    
    Specified by:
    
    getConverter in interface FormFieldComponent
    
    Returns:
    
    the converter.
  - setConverter
```
public void setConverter(Function<String,String> converter)
```
    Description copied from interface: FormFieldComponent
    
    Sets the string converter.
    Besides the lower/uppercase conversion an optional converter may be set to translate characters.
    
    Specified by:
    
    setConverter in interface FormFieldComponent
    
    Parameters:
    
    converter - the converter, null if none (default)
  - getParentWindow
```
public Window getParentWindow()
```
    Description copied from interface: FormComponent
    
    Gets the parent window of this component.
    
    Specified by:
    
    getParentWindow in interface FormComponent
    
    Returns:
    
    the parent window, null if none
  - invalidateParentInfo
```
public void invalidateParentInfo()
```
    Description copied from interface: FormComponent
    
    Invalidates all container-relevant (cached) information for the hierarchy of this component's parents.
    For optimization purposes.
    
    Specified by:
    
    invalidateParentInfo in interface FormComponent
  - getToolTipText
```
public String getToolTipText()
```
    Gets the tooltip text for this component.
    Overridden to show tooltip in tooltipdisplay OR via mouse but not both.
    
    Specified by:
    
    getToolTipText in interface FormFieldComponent
    
    Overrides:
    
    getToolTipText in class JComponent
    
    Returns:
    
    the tooltip text, null = none
  - wasTransferFocus
```
public boolean wasTransferFocus()
```
    Description copied from interface: FormComponent
    
    Returns whether this component lost the keyboard focus due to FormComponent.transferFocus().
    
    Specified by:
    
    wasTransferFocus in interface FormComponent
    
    Returns:
    
    true if focus lost due to transferFocus
  - wasTransferFocusBackward
```
public boolean wasTransferFocusBackward()
```
    Description copied from interface: FormComponent
    
    Returns whether this component lost the keyboard focus due to FormComponent.transferFocusBackward().
    
    Specified by:
    
    wasTransferFocusBackward in interface FormComponent
    
    Returns:
    
    true if focus lost due to transferFocusBackward
  - wasFocusGainedFromTransfer
```
public boolean wasFocusGainedFromTransfer()
```
    Description copied from interface: FormComponent
    
    Returns whether the keyboard focus was gained due to FormComponent.transferFocus() in the opposite component.
    
    Specified by:
    
    wasFocusGainedFromTransfer in interface FormComponent
    
    Returns:
    
    true if this component gained the focus from the logically previous component
    
    See Also:
    
    FormFocusTraversalPolicy
  - wasFocusGainedFromTransferBackward
```
public boolean wasFocusGainedFromTransferBackward()
```
    Description copied from interface: FormComponent
    
    Returns whether the keyboard focus was gained due to FormComponent.transferFocusBackward() in the opposite component.
    
    Specified by:
    
    wasFocusGainedFromTransferBackward in interface FormComponent
    
    Returns:
    
    true if this component gained the focus from the logically next component
    
    See Also:
    
    FormFocusTraversalPolicy
  - wasTransferFocusByEnter
```
public boolean wasTransferFocusByEnter()
```
    Description copied from interface: FormComponent
    
    Returns whether this component lost the keyboard focus due to KeyEvent.VK_ENTER.
    
    Specified by:
    
    wasTransferFocusByEnter in interface FormComponent
    
    Returns:
    
    true if pressing the Enter/Return key caused a focus lost
  - setFormTraversable
```
public void setFormTraversable(boolean formTraversable)
```
    Description copied from interface: FormComponent
    
    Sets whether this component is form traversable or not, i.e. gets the focus or is skipped.
    
    Specified by:
    
    setFormTraversable in interface FormComponent
    
    Parameters:
    
    formTraversable - true if traversable, false if not
  - isFormTraversable
```
public boolean isFormTraversable()
```
    Description copied from interface: FormComponent
    
    Returns whether this component is form traversable or not.
    
    Specified by:
    
    isFormTraversable in interface FormComponent
    
    Returns:
    
    the focus traversable flag
  - setFocusTraversalGroup
```
public void setFocusTraversalGroup(FocusTraversalGroup group)
```
    Description copied from interface: FormComponent
    
    Sets the focus traversal group for this component.
    
    Specified by:
    
    setFocusTraversalGroup in interface FormComponent
    
    Parameters:
    
    group - the focus traversal group
  - getFocusTraversalGroup
```
public FocusTraversalGroup getFocusTraversalGroup()
```
    Description copied from interface: FormComponent
    
    Gets the focus traversal group for this component.
    
    Specified by:
    
    getFocusTraversalGroup in interface FormComponent
    
    Returns:
    
    the focus traversal group
  - setPropertyGroup
```
public void setPropertyGroup(PropertyGroup group)
```
    Description copied from interface: FormComponent
    
    Sets the property group for this component.
    
    Specified by:
    
    setPropertyGroup in interface FormComponent
    
    Parameters:
    
    group - the property group
  - getPropertyGroup
```
public PropertyGroup getPropertyGroup()
```
    Description copied from interface: FormComponent
    
    Gets the property group for this component.
    
    Specified by:
    
    getPropertyGroup in interface FormComponent
    
    Returns:
    
    the property group
  - setMandatory
```
public void setMandatory(boolean mandatory)
```
    Description copied from interface: FormComponent
    
    Sets the mandatory option.
    Mandatory fields are differently visualized. There is no further functional difference.
    
    Specified by:
    
    setMandatory in interface FormComponent
    
    Parameters:
    
    mandatory - true if mandatory
  - isMandatory
```
public boolean isMandatory()
```
    Description copied from interface: FormComponent
    
    Gets the mandatory option.
    
    Specified by:
    
    isMandatory in interface FormComponent
    
    Returns:
    
    true if mandatory
  - setComponentPath
```
public void setComponentPath(String componentPath)
```
    Description copied from interface: FormComponent
    
    Sets the component path.
    The path is <declaring-class-name>.<field-name>. Example "de.krake.invoicer.InvoicePanel.customerNumberField".
    Notice: the component path is set during binding.
    
    Specified by:
    
    setComponentPath in interface FormComponent
    
    Parameters:
    
    componentPath - the component path
  - getComponentPath
```
public String getComponentPath()
```
    Description copied from interface: FormComponent
    
    Gets the component path.
    
    Specified by:
    
    getComponentPath in interface FormComponent
    
    Returns:
    
    the component path, null if not bound
  - setBindingPath
```
public void setBindingPath(String bindingPath)
```
    Description copied from interface: FormComponent
    
    Sets the path to bind this component to.
    Usually the binding path will be determined from the components declared name. However, it can be set programatically as well.
    
    Specified by:
    
    setBindingPath in interface FormComponent
    
    Parameters:
    
    bindingPath - the binding path, for ex. "invoiceNumber", null if autobinding
    
    See Also:
    
    Binder
  - getBindingPath
```
public String getBindingPath()
```
    Description copied from interface: FormComponent
    
    Gets the binding path.
    
    Specified by:
    
    getBindingPath in interface FormComponent
    
    Returns:
    
    the field path, null if autobinding (default)
  - setBinding
```
public void setBinding(FormComponentBinding binding)
```
    Description copied from interface: FormComponent
    
    Sets the binding.
    
    Specified by:
    
    setBinding in interface FormComponent
    
    Parameters:
    
    binding - the binding, null if none.
  - getBinding
```
public FormComponentBinding getBinding()
```
    Description copied from interface: FormComponent
    
    Gets the binding.
    
    Specified by:
    
    getBinding in interface FormComponent
    
    Returns:
    
    the binding, null if none
  - setBindable
```
public void setBindable(boolean bindable)
```
    Description copied from interface: FormComponent
    
    Sets whether this component is bindable.
    FormComponents are bindable by default.
    
    Specified by:
    
    setBindable in interface FormComponent
    
    Parameters:
    
    bindable - true if bindable, else not eligible for the binding process
  - isBindable
```
public boolean isBindable()
```
    Description copied from interface: FormComponent
    
    Determines whether this component is bindable.
    
    Specified by:
    
    isBindable in interface FormComponent
    
    Returns:
    
    true if bindable, else not eligible for the binding process
  - getValueShown
```
public String getValueShown()
```
    Description copied from interface: FormComponent
    
    Gets the value shown to the user.
    This is the visual representation, not necessarily the model's value. Used to implemement smartValueEntered.
    
    Specified by:
    
    getValueShown in interface FormComponent
    
    Returns:
    
    the value visible to the user
  - isValueShownModified
```
public boolean isValueShownModified()
```
    Description copied from interface: FormComponent
    
    Checks whether the currently shown value differs from the initially shown.
    Used to implement smartValueEntered.
    
    Specified by:
    
    isValueShownModified in interface FormComponent
    
    Returns:
    
    true if user changed the visual representation
  - clearValueShownModified
```
public void clearValueShownModified()
```
    Description copied from interface: FormComponent
    
    Clears the value shown status.
    May be used by components that update the value shown programmatically.
    
    Specified by:
    
    clearValueShownModified in interface FormComponent
  - setSmartValueEntered
```
public void setSmartValueEntered(boolean smartValueEntered)
```
    Description copied from interface: FormComponent
    
    Sets whether the model should only be updated if the component's value really changed.
    The default is true.
    
    Specified by:
    
    setSmartValueEntered in interface FormComponent
    
    Parameters:
    
    smartValueEntered - true if optimize, false if always update the model
  - isSmartValueEntered
```
public boolean isSmartValueEntered()
```
    Description copied from interface: FormComponent
    
    Returns whether the model should only be updated if the component's value really changed.
    The default is true.
    
    Specified by:
    
    isSmartValueEntered in interface FormComponent
    
    Returns:
    
    true if optimize, false if always update the model

Class AbstractFormField

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JTextField

Nested classes/interfaces inherited from class javax.swing.text.JTextComponent

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JTextField

Fields inherited from class javax.swing.text.JTextComponent

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface org.tentackle.swing.FormFieldComponent

Fields inherited from interface javax.swing.SwingConstants

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class javax.swing.JTextField

Methods inherited from class javax.swing.text.JTextComponent

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Methods inherited from interface org.tentackle.swing.FormFieldComponent

Methods inherited from interface org.tentackle.swing.FormComponent

Field Detail

errorOffset

errorMessage

savedValue

Constructor Detail

AbstractFormField

AbstractFormField

AbstractFormField

AbstractFormField

AbstractFormField

Method Detail

processKeyBinding

restoreSavedValue

setColumns

createDefaultModel

processFocusEvent

setText

getText

transferFocus

transferFocusBackward

showErrorPopup

hideErrorPopup

showErrorPopup

addValueListener

removeValueListener

requestFocusLater

fireValueChanged

fireValueEntered

saveValue

isValueChanged

setTriggerValueChangedEnabled

isTriggerValueChangedEnabled

triggerValueChanged

setCellEditorUsage

isCellEditorUsage

prepareFocusLost

showHelp

clearText

isEmpty

isCaretLeft

isCaretRight

upLeft

downRight

setCaretLeft

setCaretRight

setEraseFirst

isEraseFirst

setChangeable

isChangeable

setHonourChangeable

isHonourChangeable

updateAllChangeable

setEditable

getDefaultColumns

setDefaultColumns