xdev.ui

Class XdevFormattedTextField

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.text.JTextComponent

javax.swing.JTextField

javax.swing.JFormattedTextField

xdev.ui.XdevFormattedTextField

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable, SwingConstants, ClientProperties, FormattedFormularComponent<XdevFormattedTextField>, FormularComponent<XdevFormattedTextField>, NumberFormularComponent<XdevFormattedTextField>, TextComponent, XdevFocusCycleComponent

@BeanSettings(useXdevCustomizer=true)
public class XdevFormattedTextField
extends JFormattedTextField
implements ClientProperties, TextComponent, FormattedFormularComponent<XdevFormattedTextField>, NumberFormularComponent<XdevFormattedTextField>, XdevFocusCycleComponent

The standard formatted textfield in XDEV. Based on JFormattedTextField.

Since:

2.0

Author:

XDEV Software

See Also:

JFormattedTextField, ClientProperties, FormattedFormularComponent, XdevFocusCycleComponent, Serialized Form

Nested Class Summary

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

JFormattedTextField.AbstractFormatter, JFormattedTextField.AbstractFormatterFactory

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

Nested classes/interfaces inherited from interface xdev.ui.FormularComponent

FormularComponent.ValueChangeListener

Field Summary

Fields inherited from class javax.swing.JFormattedTextField

COMMIT, COMMIT_OR_REVERT, PERSIST, REVERT

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 xdev.ui.ClientProperties

DATA_FIELD, FORMULAR_CONDITION_FILTER, FORMULAR_CONDITION_PRECISION, FORMULAR_FILTER_OPERATOR, FORMULAR_SKIP, FORMULAR_VERIFIER, TAG_DATA

Fields inherited from interface xdev.ui.FormularComponent

DATA_FIELD_SEPARATOR

Fields inherited from interface xdev.ui.XdevFocusCycleComponent

TAB_INDEX_PROPERTY

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
XdevFormattedTextField() Constructor for creating a new instance of a XdevFormattedTextField.
XdevFormattedTextField(int maxSigns, TextFormat textFormat) Constructor for creating a new instance of a XdevFormattedTextField.
XdevFormattedTextField(String text, int maxSigns, TextFormat textFormat) Constructor for creating a new instance of a XdevFormattedTextField.
XdevFormattedTextField(String text, TextFormat textFormat) Constructor for creating a new instance of a XdevFormattedTextField.
XdevFormattedTextField(TextFormat textFormat) Constructor for creating a new instance of a XdevFormattedTextField.

Method Summary

Modifier and Type	Method and Description
void	addDocumentListener(DocumentListener listener) Registers the given DocumentListener to begin receiving notifications when changes are made to the document.
void	addValidator(Validator validator) Adds a validator to this component
void	addValueChangeListener(FormularComponent.ValueChangeListener l) Registers a FormularComponent.ValueChangeListener.
void	commitEdit()
String	getDataField() Returns the name of the bound data field of this formular component.
XdevDate	getDate() Returns the value of this XdevFormattedTextField as XdevDate.
XdevDate	getDate(XdevDate defaultValue) Returns the value of this XdevFormattedTextField as XdevDate.
double	getDouble() Returns the value of this XdevFormattedTextField as double.
double	getDouble(double defaultValue) Returns the value of this XdevFormattedTextField as double.
Operator	getFilterOperator() Returns the operator used in Formular.createCondition(String)
FocusGainedBehavior	getFocusGainedBehavior() Returns the FocusGainedBehavior of this TextComponent.
String	getFormularName() Returns the name of the component in the formular context.
Object	getFormularValue() Returns the value of the component.
int	getInt() Returns the value of this XdevFormattedTextField as int.
int	getInt(int defaultValue) Returns the value of this XdevFormattedTextField as int.
int	getMaxSignCount() Returns the max sign count of this XdevFormattedTextField.
Number	getNumber() Returns the value of this XdevFormattedTextField as Number.
Number	getNumber(Number defaultValue) Returns the value of this XdevFormattedTextField as Number.
Dimension	getPreferredSize()
String	getSelectedText() Returns the selected text contained in this XdevFormattedTextField.
int	getTabIndex() Returns the tabindex assigned to this component.
TextChangedBehavior	getTextChangedBehavior() Return the TextChangedBehavior of this TextComponent
TextFormat	getTextFormat() Returns the associated TextFormat of this component.
Validator[]	getValidators() Returns all validators of this component.
boolean	hasStateChanged() Checks if the component's state since the last call of FormularComponent.saveState() has changed.
void	insertText(String text) Inserts a String into this XdevFormattedTextField.
boolean	isMultiSelect() Returns whether the component supports multi selection or not.
boolean	isReadOnly() Determines whether this component is only used to display values.
void	removeDocumentListener(DocumentListener listener) Unregisters the given DocumentListener from the notification list so it will no longer receive change updates.
void	removeValidator(Validator validator) Removes a validator from this component
void	reset() Sets the text back to an empty String. Has the same effect as setValue(null).
void	restoreState() Restores the internally saved state of the component.
void	saveState() Saves the state of the component internally.
void	setDataField(String dataField) Sets the name of the bound data field of this formular component.
void	setFilterOperator(Operator filterOperator) Sets the filter operator used in Formular.createCondition(String)
void	setFocusGainedBehavior(FocusGainedBehavior focusGainedBehavior) Sets the new FocusGainedBehavior for this TextComponent.
void	setFormularValue(VirtualTable vt, int col, Object value) Deprecated.
void	setFormularValue(VirtualTable vt, Map<String,Object> record) Sets the value of the component, taking the value(s) of the record according to FormularComponent.getDataField().
void	setMaxSignCount(int maxSignCount) Sets the max sign count of this XdevFormattedTextField.
void	setNumber(Number number) Sets the number of this NumberFormularComponent.
void	setReadOnly(boolean readOnly) Sets if this form component is only used to display values.
void	setTabIndex(int tabIndex) Sets the tabindex of this component.
void	setText(String str) Sets the text of this TextComponent to the specified text.
void	setTextChangedBehavior(TextChangedBehavior textChangedBehavior) Sets the new TextChangedBehavior for this TextComponent.
void	setTextFormat(TextFormat format) Sets the new TextFormat which is used to format the displayed value of this component.
String	toString()
void	validateState() Calls Validator.validate(Object) of all registered Validators.
void	validateState(Validation validation) Calls Validator.validate(Object) of all registered Validators.
boolean	verify() Returns whether the component's value adheres all set constraints.

Methods inherited from class javax.swing.JFormattedTextField

getActions, getFocusLostBehavior, getFormatter, getFormatterFactory, getUIClassID, getValue, invalidEdit, isEditValid, processFocusEvent, processInputMethodEvent, setDocument, setFocusLostBehavior, setFormatter, setFormatterFactory, setValue

Methods inherited from class javax.swing.JTextField

actionPropertyChanged, addActionListener, configurePropertiesFromAction, createActionPropertyChangeListener, createDefaultModel, fireActionPerformed, getAccessibleContext, getAction, getActionListeners, getColumns, getColumnWidth, getHorizontalAlignment, getHorizontalVisibility, getScrollOffset, isValidateRoot, paramString, postActionEvent, removeActionListener, scrollRectToVisible, setAction, setActionCommand, setColumns, setFont, setHorizontalAlignment, setScrollOffset

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, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paste, print, print, print, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, 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, getToolTipText, 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, processKeyBinding, 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, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface xdev.ui.TextComponent

getText

Methods inherited from interface xdev.ui.FormularComponent

getClientProperty, isEnabled, isVisible, putClientProperty

Constructor Detail

XdevFormattedTextField

public XdevFormattedTextField()

Constructor for creating a new instance of a XdevFormattedTextField.

XdevFormattedTextField

public XdevFormattedTextField(TextFormat textFormat)

Constructor for creating a new instance of a XdevFormattedTextField.

Parameters:

textFormat - the TextFormat to format the display text, null if none

XdevFormattedTextField

public XdevFormattedTextField(String text,
                              TextFormat textFormat)

Constructor for creating a new instance of a XdevFormattedTextField.

Parameters:

text - the text to be displayed, null if none

textFormat - the TextFormat to format the display text, null if none

XdevFormattedTextField

public XdevFormattedTextField(int maxSigns,
                              TextFormat textFormat)
                       throws IllegalArgumentException

Constructor for creating a new instance of a XdevFormattedTextField.

Parameters:

maxSigns - a int to determine the max signs of the MaxSignDocument

textFormat - the TextFormat to format the display text, null if none

Throws:

IllegalArgumentException - if the maxSigns is <= 0

XdevFormattedTextField

public XdevFormattedTextField(String text,
                              int maxSigns,
                              TextFormat textFormat)
                       throws IllegalArgumentException

Constructor for creating a new instance of a XdevFormattedTextField.

Parameters:

text - the text to be displayed, null if none

maxSigns - a int to determine the max signs of the MaxSignDocument

textFormat - the TextFormat to format the display text, null if none

Throws:

IllegalArgumentException - if the maxSigns is <= 0

Method Detail

getFocusGainedBehavior

public FocusGainedBehavior getFocusGainedBehavior()

Returns the FocusGainedBehavior of this TextComponent.

Returns:

the FocusGainedBehavior of this TextComponent

Since:

3.1

setFocusGainedBehavior

public void setFocusGainedBehavior(FocusGainedBehavior focusGainedBehavior)

Sets the new FocusGainedBehavior for this TextComponent.

Parameters:

focusGainedBehavior - the new FocusGainedBehavior

Throws:

{@link - IllegalArgumentException} if focusGainedBehavior is null

Since:

3.1

getTextChangedBehavior

public TextChangedBehavior getTextChangedBehavior()

Return the TextChangedBehavior of this TextComponent

Returns:

the TextChangedBehavior of this TextComponent

Since:

4.0

setTextChangedBehavior

public void setTextChangedBehavior(TextChangedBehavior textChangedBehavior)

Sets the new TextChangedBehavior for this TextComponent.

Parameters:

textChangedBehavior - the new TextChangedBehavior

Throws:

{@link - IllegalArgumentException} if textChangedBehavior is null

Since:

4.0

setText

public void setText(String str)

Sets the text of this TextComponent to the specified text. If the text is null or empty, has the effect of simply deleting the old text.

Specified by:

setText in interface TextComponent

Overrides:

setText in class JTextComponent

Parameters:

str - the new text to be set

See Also:

UIUtils.scrollToStart(javax.swing.JComponent)

getPreferredSize

public Dimension getPreferredSize()

Overrides:

getPreferredSize in class JTextField

addDocumentListener

public void addDocumentListener(DocumentListener listener)

Registers the given DocumentListener to begin receiving notifications when changes are made to the document.

Parameters:

listener - the DocumentListener to register

See Also:

Document.addDocumentListener(DocumentListener)

removeDocumentListener

public void removeDocumentListener(DocumentListener listener)

Unregisters the given DocumentListener from the notification list so it will no longer receive change updates.

Parameters:

listener - the observer to register

See Also:

addDocumentListener(DocumentListener)

getMaxSignCount

public int getMaxSignCount()

Returns the max sign count of this XdevFormattedTextField.

Returns:

the max sign count of this XdevFormattedTextField, -1 if the Document is not an instance of MaxSignDocument.

See Also:

MaxSignDocument

setMaxSignCount

public void setMaxSignCount(int maxSignCount)

Sets the max sign count of this XdevFormattedTextField.

Parameters:

maxSignCount - the max sign count of this XdevFormattedTextField

getFormularName

public String getFormularName()

Returns the name of the component in the formular context.

Specified by:

getFormularName in interface FormularComponent<XdevFormattedTextField>

Returns:

the name of the component in the formular context.

setDataField

public void setDataField(String dataField)

Sets the name of the bound data field of this formular component.

Specified by:

setDataField in interface FormularComponent<XdevFormattedTextField>

Parameters:

dataField - the new bound data field

Since:

3.1

getDataField

public String getDataField()

Returns the name of the bound data field of this formular component.

Specified by:

getDataField in interface FormularComponent<XdevFormattedTextField>

Returns:

the name of the bound data field

Since:

3.1

setFormularValue

@Deprecated
public final void setFormularValue(VirtualTable vt,
                                               int col,
                                               Object value)

Deprecated.

Sets the value of the component according to the provided value value. The value is formatted using the column format of the provided VirtualTable and columnIndex.

Specified by:

setFormularValue in interface FormularComponent<XdevFormattedTextField>

Parameters:

vt - VirtualTable to use the format from

col - of the column to use the format from

value - value to set

setFormularValue

public void setFormularValue(VirtualTable vt,
                             Map<String,Object> record)

Sets the value of the component, taking the value(s) of the record according to FormularComponent.getDataField().

Specified by:

setFormularValue in interface FormularComponent<XdevFormattedTextField>

Parameters:

vt - the underlying virtual table

record - the data <column,value>

Since:

3.2

getFormularValue

public Object getFormularValue()

Returns the value of the component.

Specified by:

getFormularValue in interface FormularComponent<XdevFormattedTextField>

Returns:

the value of the component.

getTextFormat

public TextFormat getTextFormat()

Returns the associated TextFormat of this component.

Specified by:

getTextFormat in interface FormattedFormularComponent<XdevFormattedTextField>

Returns:

the associated TextFormat of this component

setTextFormat

public void setTextFormat(TextFormat format)

Sets the new TextFormat which is used to format the displayed value of this component.

Specified by:

setTextFormat in interface FormattedFormularComponent<XdevFormattedTextField>

Parameters:

format - the new TextFormat

commitEdit

public void commitEdit()
                throws ParseException

Overrides:

commitEdit in class JFormattedTextField

Throws:

ParseException

saveState

public void saveState()

Saves the state of the component internally.

A saved state can be restored using FormularComponent.restoreState().

Specified by:

saveState in interface FormularComponent<XdevFormattedTextField>

restoreState

public void restoreState()

Restores the internally saved state of the component.

The state of the component can be saved using FormularComponent.saveState().

Specified by:

restoreState in interface FormularComponent<XdevFormattedTextField>

hasStateChanged

public boolean hasStateChanged()

Checks if the component's state since the last call of FormularComponent.saveState() has changed.

Specified by:

hasStateChanged in interface FormularComponent<XdevFormattedTextField>

Returns:

true if the component's state has changed, false otherwise

Since:

3.1

addValueChangeListener

public void addValueChangeListener(FormularComponent.ValueChangeListener l)

Registers a FormularComponent.ValueChangeListener.

Specified by:

addValueChangeListener in interface FormularComponent<XdevFormattedTextField>

Parameters:

l - the listener to register

Since:

3.1

isMultiSelect

public boolean isMultiSelect()

Returns whether the component supports multi selection or not.

A component that supports multi selection can have more than one selected item / value.

Specified by:

isMultiSelect in interface FormularComponent<XdevFormattedTextField>

Returns:

true if the component supports multi selection, false otherwise.

verify

public boolean verify()

Returns whether the component's value adheres all set constraints.

This is a alternative method for FormularComponent.validateState(), but this method returns a boolean depending on the validation's result and doesn't throw an ValidationException.

Specified by:

verify in interface FormularComponent<XdevFormattedTextField>

Returns:

true if the value of the component adheres all set constraints; otherwise false.

addValidator

public void addValidator(Validator validator)

Adds a validator to this component

Specified by:

addValidator in interface FormularComponent<XdevFormattedTextField>

Parameters:

validator - the validator to add

Since:

3.1

See Also:

FormularComponent.validateState()

removeValidator

public void removeValidator(Validator validator)

Removes a validator from this component

Specified by:

removeValidator in interface FormularComponent<XdevFormattedTextField>

Parameters:

validator - the validator to remove

Since:

3.1

See Also:

FormularComponent.validateState()

getValidators

public Validator[] getValidators()

Returns all validators of this component.

If no validator is present an empty array is returned.

Specified by:

getValidators in interface FormularComponent<XdevFormattedTextField>

Returns:

all validators of this component

Since:

3.1

validateState

public void validateState()
                   throws ValidationException

Calls Validator.validate(Object) of all registered Validators.

Specified by:

validateState in interface FormularComponent<XdevFormattedTextField>

Throws:

ValidationException

Since:

3.1

See Also:

FormularComponent.verify()

validateState

public void validateState(Validation validation)
                   throws ValidationException

Calls Validator.validate(Object) of all registered Validators.

Every ValidationException is recorded in the validation object, and if Validation.continueValidation(ValidationException) returns false this exception is re-thrown by this method.

Specified by:

validateState in interface FormularComponent<XdevFormattedTextField>

Parameters:

validation - the validation process object

Throws:

ValidationException

Since:

3.1

See Also:

FormularComponent.verify()

setFilterOperator

public void setFilterOperator(Operator filterOperator)

Sets the filter operator used in Formular.createCondition(String)

Specified by:

setFilterOperator in interface FormularComponent<XdevFormattedTextField>

Parameters:

filterOperator - the new filter operator

Since:

3.1

getFilterOperator

public Operator getFilterOperator()

Returns the operator used in Formular.createCondition(String)

Specified by:

getFilterOperator in interface FormularComponent<XdevFormattedTextField>

Returns:

the component's filter operator

Since:

3.1

setReadOnly

public void setReadOnly(boolean readOnly)

Sets if this form component is only used to display values.

Specified by:

setReadOnly in interface FormularComponent<XdevFormattedTextField>

Parameters:

readOnly - true to only display values

Since:

3.2

isReadOnly

public boolean isReadOnly()

Determines whether this component is only used to display values.

Specified by:

isReadOnly in interface FormularComponent<XdevFormattedTextField>

Returns:

true if this component is only used to display values.

Since:

3.2

reset

public void reset()

Sets the text back to an empty String.
Has the same effect as setValue(null).

getSelectedText

public String getSelectedText()
                       throws IllegalArgumentException

Returns the selected text contained in this XdevFormattedTextField. If the selection is null or the document empty, returns a empty String.

Overrides:

getSelectedText in class JTextComponent

Returns:

the selected text, or a empty String

Throws:

IllegalArgumentException - if the selection doesn't have a valid mapping into the document for some reason

See Also:

setText(java.lang.String), JTextComponent.getSelectedText()

insertText

public void insertText(String text)

Inserts a String into this XdevFormattedTextField.

Parameters:

text - the String to insert

See Also:

Document.insertString(int, String, javax.swing.text.AttributeSet)

getDate

public XdevDate getDate()
                 throws DateFormatException

Returns the value of this XdevFormattedTextField as XdevDate.

Returns:

the value of this XdevFormattedTextField as XdevDate.

Throws:

DateFormatException - if no TextFormat is existing or the value of this XdevFormattedTextField can not be converted.

See Also:

getDate(XdevDate), getInt(), getDouble()

getDate

public XdevDate getDate(XdevDate defaultValue)

Returns the value of this XdevFormattedTextField as XdevDate. If the internal value can not be converted into a XdevDate, the defaultValue is returned.

Parameters:

defaultValue - the default XdevDate

Returns:

the value of this XdevFormattedTextField. If the internal value can not be converted into a XdevDate, the defaultValue is returned.

See Also:

getDate()

getInt

public int getInt()
           throws NumberFormatException

Returns the value of this XdevFormattedTextField as int.

Returns:

the value of this XdevFormattedTextField as int.

Throws:

NumberFormatException - if no TextFormat is existing or the value of this XdevFormattedTextField can not be converted.

See Also:

getInt(int), getNumber(), getDate(), getDouble()

getInt

public int getInt(int defaultValue)

Returns the value of this XdevFormattedTextField as int. If the internal value can not be converted into a int, the defaultValue is returned.

Parameters:

defaultValue - the default int

Returns:

the value of this XdevFormattedTextField. If the internal value can not be converted into a int, the defaultValue is returned.

See Also:

getInt()

getDouble

public double getDouble()
                 throws NumberFormatException

Returns the value of this XdevFormattedTextField as double.

Returns:

the value of this XdevFormattedTextField as double

Throws:

NumberFormatException - if no TextFormat is existing or the value of this XdevFormattedTextField can not be converted.

See Also:

getDouble(double), getNumber(), getDate(), getInt()

getDouble

public double getDouble(double defaultValue)

Returns the value of this XdevFormattedTextField as double. If the internal value can not be converted into a double, the defaultValue is returned.

Parameters:

defaultValue - the default double

Returns:

the value of this XdevFormattedTextField. If the internal value can not be converted into a double, the defaultValue is returned.

See Also:

getDouble()

getNumber

public Number getNumber()
                 throws NumberFormatException

Returns the value of this XdevFormattedTextField as Number.

Specified by:

getNumber in interface NumberFormularComponent<XdevFormattedTextField>

Returns:

the value of this XdevFormattedTextField as Number

Throws:

NumberFormatException - if no TextFormat is existing or the value of this XdevFormattedTextField can not be converted.

See Also:

getNumber(Number), getDouble(), getDate(), getInt()

getNumber

public Number getNumber(Number defaultValue)

Returns the value of this XdevFormattedTextField as Number. If the internal value can not be converted into a Number, the defaultValue is returned.

Specified by:

getNumber in interface NumberFormularComponent<XdevFormattedTextField>

Parameters:

defaultValue - the default Number

Returns:

the value of this XdevFormattedTextField. If the internal value can not be converted into a Number, the defaultValue is returned.

See Also:

getNumber(), getDouble(), getDate(), getInt()

setNumber

public void setNumber(Number number)

Sets the number of this NumberFormularComponent.

Specified by:

setNumber in interface NumberFormularComponent<XdevFormattedTextField>

Parameters:

number - the new number

toString

public String toString()

Overrides:

toString in class Component

getTabIndex

public int getTabIndex()

Returns the tabindex assigned to this component. The tabindex defines the position of the component in the focus cycle.

Specified by:

getTabIndex in interface XdevFocusCycleComponent

Returns:

tabindex of this component

setTabIndex

public void setTabIndex(int tabIndex)

Sets the tabindex of this component. The tabindex defines the position of the component in the focus cycle.

To exclude this component from the focus cycle set tabindex to -1.

Specified by:

setTabIndex in interface XdevFocusCycleComponent

Parameters:

tabIndex - to be set