com.guiseframework.component
Class AbstractTextControl<V>

java.lang.Object
  com.globalmentor.beans.BoundPropertyObject
      com.guiseframework.event.GuiseBoundPropertyObject
          com.guiseframework.model.ui.AbstractPresentationModel
              com.guiseframework.component.AbstractComponent
                  com.guiseframework.component.AbstractControl
                      com.guiseframework.component.AbstractValueControl<V>
                          com.guiseframework.component.AbstractEditValueControl<V>
                              com.guiseframework.component.AbstractTextControl<V>

Type Parameters:

V - The type of value the input text is to represent.

All Implemented Interfaces:

com.globalmentor.beans.PropertyBindable, com.globalmentor.beans.PropertyConstrainable, Component, Control, EditComponent, InputFocusableComponent, ValueControl<V>, ValuedComponent<V>, EditListenable, Displayable, Enableable, InfoModel, LabelModel, Model, PresentationModel, Valued<V>, ValueModel<V>, DepictedObject

Direct Known Subclasses:

TextControl

public class AbstractTextControl<V>
extends AbstractEditValueControl<V>

Control to accept text input from the user representing a particular value type. This control keeps track of literal text entered by the user, distinct from the value stored in the model. The component valid status is updated before any literal text change event is fired. Default converters are available for the following types:

• char[]
• java.lang.Boolean
• java.lang.Float
• java.lang.Integer
• java.lang.String

This control uses a single line feed character to represent each line break.

Author:

Garret Wilson

Nested Class Summary

Nested classes/interfaces inherited from class com.guiseframework.component.AbstractComponent

AbstractComponent.AbstractFlyoverFrameStrategy<S extends Component>, AbstractComponent.AbstractFlyoverStrategy<S extends Component>, AbstractComponent.DefaultFlyoverStrategy<S extends Component>

Nested classes/interfaces inherited from interface com.guiseframework.component.Component

Component.FlyoverStrategy<S extends Component>

Nested classes/interfaces inherited from interface com.guiseframework.component.Control

Control.Status

Field Summary

static java.lang.String	AUTO_COMMIT_PATTERN_PROPERTY The auto commit pattern bound property.
static java.lang.String	COLUMN_COUNT_PROPERTY The column count bound property.
static java.lang.String	PROVISIONAL_TEXT_PROPERTY The provisional text literal bound property.
static java.lang.String	TEXT_PROPERTY The text literal bound property.
static java.lang.String	VALUE_CONTENT_TYPE_PROPERTY The value content type bound property.

Fields inherited from class com.globalmentor.beans.BoundPropertyObject

NO_PROPERTY_CHANGE_LISTENERS, NO_VETOABLE_CHANGE_LISTENERS

Fields inherited from interface com.guiseframework.component.EditComponent

EDITABLE_PROPERTY

Fields inherited from interface com.guiseframework.component.Component

BOOKMARK_ENABLED_PROPERTY, CONSTRAINTS_PROPERTY, DRAG_ENABLED_PROPERTY, DROP_ENABLED_PROPERTY, FLYOVER_ENABLED_PROPERTY, FLYOVER_STRATEGY_PROPERTY, INPUT_STRATEGY_PROPERTY, NAME_PROPERTY, NOTIFICATION_PROPERTY, ORIENTATION_PROPERTY, THEME_APPLIED_PROPERTY, VALID_PROPERTY

Fields inherited from interface com.guiseframework.model.ui.PresentationModel

BACKGROUND_COLOR_PROPERTY, BORDER_LINE_FAR_COLOR_PROPERTY, BORDER_LINE_FAR_EXTENT_PROPERTY, BORDER_LINE_FAR_STYLE_PROPERTY, BORDER_LINE_NEAR_COLOR_PROPERTY, BORDER_LINE_NEAR_EXTENT_PROPERTY, BORDER_LINE_NEAR_STYLE_PROPERTY, BORDER_PAGE_FAR_COLOR_PROPERTY, BORDER_PAGE_FAR_EXTENT_PROPERTY, BORDER_PAGE_FAR_STYLE_PROPERTY, BORDER_PAGE_NEAR_COLOR_PROPERTY, BORDER_PAGE_NEAR_EXTENT_PROPERTY, BORDER_PAGE_NEAR_STYLE_PROPERTY, CORNER_LINE_FAR_PAGE_FAR_ARC_SIZE_PROPERTY, CORNER_LINE_FAR_PAGE_NEAR_ARC_SIZE_PROPERTY, CORNER_LINE_NEAR_PAGE_FAR_ARC_SIZE_PROPERTY, CORNER_LINE_NEAR_PAGE_NEAR_ARC_SIZE_PROPERTY, CURSOR_PROPERTY, FONT_FAMILIES_PROPERTY, FONT_SIZE_PROPERTY, FONT_STYLE_PROPERTY, FONT_WEIGHT_BOLD, FONT_WEIGHT_NORMAL, FONT_WEIGHT_PROPERTY, LABEL_FONT_FAMILIES_PROPERTY, LABEL_FONT_SIZE_PROPERTY, LABEL_FONT_STYLE_PROPERTY, LABEL_FONT_WEIGHT_PROPERTY, LABEL_TEXT_COLOR_PROPERTY, LINE_EXTENT_PROPERTY, MARGIN_LINE_FAR_EXTENT_PROPERTY, MARGIN_LINE_NEAR_EXTENT_PROPERTY, MARGIN_PAGE_FAR_EXTENT_PROPERTY, MARGIN_PAGE_NEAR_EXTENT_PROPERTY, OPACITY_PROPERTY, PADDING_LINE_FAR_EXTENT_PROPERTY, PADDING_LINE_NEAR_EXTENT_PROPERTY, PADDING_PAGE_FAR_EXTENT_PROPERTY, PADDING_PAGE_NEAR_EXTENT_PROPERTY, PAGE_EXTENT_PROPERTY, ROUNDED_CORNER_ARC_SIZE, STYLE_ID_PROPERTY, TEXT_COLOR_PROPERTY, TOOLTIP_ENABLED_PROPERTY, VISIBLE_PROPERTY

Fields inherited from interface com.guiseframework.model.Displayable

DISPLAYED_PROPERTY

Fields inherited from interface com.guiseframework.model.InfoModel

DESCRIPTION_CONTENT_TYPE_PROPERTY, DESCRIPTION_PROPERTY, INFO_CONTENT_TYPE_PROPERTY, INFO_PROPERTY

Fields inherited from interface com.guiseframework.model.LabelModel

GLYPH_URI_PROPERTY, LABEL_CONTENT_TYPE_PROPERTY, LABEL_PROPERTY

Fields inherited from interface com.guiseframework.model.Model

PLAIN_TEXT_CONTENT_TYPE, XHTML_CONTENT_TYPE, XHTML_FRAGMENT_CONTENT_TYPE

Fields inherited from interface com.guiseframework.component.ValueControl

CONVERTER_PROPERTY

Fields inherited from interface com.guiseframework.component.Control

STATUS_PROPERTY

Fields inherited from interface com.guiseframework.model.Enableable

ENABLED_PROPERTY

Fields inherited from interface com.guiseframework.model.ValueModel

VALIDATOR_PROPERTY, VALUE_PROPERTY

Constructor Summary

AbstractTextControl(java.lang.Class<V> valueClass)
Value class constructor with a default data model to represent a given type and a default converter.

AbstractTextControl(ValueModel<V> valueModel)
Value model constructor with a default converter.

AbstractTextControl(ValueModel<V> valueModel, Converter<V,java.lang.String> converter)
Value model and converter constructor.

Method Summary

protected Control.Status	determineStatus() Checks the user input status of the control.
protected boolean	determineValid() Checks the state of the component for validity.
java.util.regex.Pattern	getAutoCommitPattern()
int	getColumnCount()
Converter<V,java.lang.String>	getConverter()
java.lang.String	getProvisionalText()
java.lang.String	getText()
com.globalmentor.net.ContentType	getValueContentType()
void	reset() Resets the control to its default value.
void	setAutoCommitPattern(java.util.regex.Pattern newAutoCommitPattern) Sets the The regular expression pattern that will cause the text automatically to be committed immediately.
void	setColumnCount(int newColumnCount) Sets the estimated number of columns requested to be visible.
void	setConverter(Converter<V,java.lang.String> newConverter) Sets the converter.
void	setProvisionalText(java.lang.String newProvisionalText) Sets the provisional text literal value.
void	setText(java.lang.String newText) Sets the text literal value displayed in the control.
void	setTextValue(java.lang.String newText) Sets the text literal value displayed in the control, and then converts the text to an appropriate value and stores it.
void	setValueContentType(com.globalmentor.net.ContentType newValueContentType) Sets the content type of the value.
protected void	updateText() Updates the component text with literal form of the given value.
boolean	validate() Validates the user input of this component and all child components.

Methods inherited from class com.guiseframework.component.AbstractEditValueControl

addEditListener, fireEdited, fireEdited, isEditable, removeEditListener, setEditable

Methods inherited from class com.guiseframework.component.AbstractValueControl

clearValue, getDefaultValue, getValidator, getValue, getValueClass, getValueModel, isValidValue, resetValue, setValidator, setValue, validateValue

Methods inherited from class com.guiseframework.component.AbstractControl

getEnableable, getStatus, isEnabled, setEnabled, setNotification, setStatus, updateStatus, updateValid

Methods inherited from class com.guiseframework.component.AbstractComponent

addCommandListener, addExportStrategy, addImportStrategy, addKeyListener, addMouseListener, addNotificationListener, addPreferenceProperty, applyTheme, applyTheme, depict, dispatchInputEvent, equals, exportTransfer, fireInputEvent, fireNotified, fireNotified, getAncestor, getCommandListeners, getComponentByID, getComponentByName, getComponentOrientation, getConstraints, getDepictID, getDepictor, getDescription, getDescriptionContentType, getDirtyComponents, getDirtyComponents, getEventListenerManager, getFlyoverStrategy, getGlyphURI, getInfo, getInfoContentType, getInfoModel, getInputStrategy, getKeyListeners, getLabel, getLabelContentType, getMouseListeners, getName, getNotification, getNotifications, getNotifications, getOrientation, getParent, getPreferenceProperties, getRootComponent, getTheme, hasAncestor, hasCommandListeners, hashCode, hasKeyListeners, hasMouseListeners, importTransfer, initialize, isDragEnabled, isDropEnabled, isFlyoverEnabled, isPreferenceProperty, isThemeApplied, isValid, loadPreferences, notify, processEvent, removeCommandListener, removeExportStrategy, removeImportStrategy, removeKeyListener, removeMouseListener, removeNotificationListener, removePreferenceProperty, resetTheme, savePreferences, setConstraints, setDepicted, setDescription, setDescriptionContentType, setDragEnabled, setDropEnabled, setFlyoverEnabled, setFlyoverStrategy, setGlyphURI, setInfo, setInfoContentType, setInputStrategy, setLabel, setLabelContentType, setName, setOrientation, setParent, setThemeApplied, setValid, toString, update, updateTheme

Methods inherited from class com.guiseframework.model.ui.AbstractPresentationModel

BorderLineFarColor, BorderLineFarExtent, BorderLineFarStyle, BorderLineNearColor, BorderLineNearExtent, BorderLineNearStyle, BorderPageFarColor, BorderPageFarExtent, BorderPageFarStyle, BorderPageNearColor, BorderPageNearExtent, BorderPageNearStyle, getBackgroundColor, getBorderColor, getBorderExtent, getBorderStyle, getCornerArcSize, getCornerLineFarPageFarArcSize, getCornerLineFarPageNearArcSize, getCornerLineNearPageFarArcSize, getCornerLineNearPageNearArcSize, getCursor, getExtent, getFontFamilies, getFontSize, getFontStyle, getFontWeight, getLabelFontFamilies, getLabelFontSize, getLabelFontStyle, getLabelFontWeight, getLabelTextColor, getLineExtent, getMarginExtent, getMarginLineFarExtent, getMarginLineNearExtent, getMarginPageFarExtent, getMarginPageNearExtent, getOpacity, getPaddingExtent, getPaddingLineFarExtent, getPaddingLineNearExtent, getPaddingPageFarExtent, getPaddingPageNearExtent, getPageExtent, getStyleID, getTextColor, isDisplayed, isTooltipEnabled, isVisible, setBackgroundColor, setBorderColor, setBorderColor, setBorderExtent, setBorderExtent, setBorderLineFarColor, setBorderLineFarExtent, setBorderLineFarStyle, setBorderLineNearColor, setBorderLineNearExtent, setBorderLineNearStyle, setBorderPageFarColor, setBorderPageFarExtent, setBorderPageFarStyle, setBorderPageNearColor, setBorderPageNearExtent, setBorderPageNearStyle, setBorderStyle, setBorderStyle, setCornerArcSize, setCornerArcSize, setCornerLineFarPageFarArcSize, setCornerLineFarPageNearArcSize, setCornerLineNearPageFarArcSize, setCornerLineNearPageNearArcSize, setCursor, setDisplayed, setExtent, setFontFamilies, setFontSize, setFontStyle, setFontWeight, setLabelFontFamilies, setLabelFontSize, setLabelFontStyle, setLabelFontWeight, setLabelTextColor, setLineExtent, setMarginExtent, setMarginExtent, setMarginLineFarExtent, setMarginLineNearExtent, setMarginPageFarExtent, setMarginPageNearExtent, setOpacity, setPaddingExtent, setPaddingExtent, setPaddingLineFarExtent, setPaddingLineNearExtent, setPaddingPageFarExtent, setPaddingPageNearExtent, setPageExtent, setStyleID, setTextColor, setTooltipEnabled, setVisible

Methods inherited from class com.guiseframework.event.GuiseBoundPropertyObject

getSession

Methods inherited from class com.globalmentor.beans.BoundPropertyObject

addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, createPostponedPropertyChangeEvent, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, getForwardPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, getPropertyChangeSupport, getRepeatPropertyChangeListener, getRepeatVetoableChangeListener, getVetoableChangeListeners, getVetoableChangeListeners, getVetoableChangeSupport, hasPropertyChangeListeners, hasVetoableChangeListeners, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.guiseframework.component.Component

addCommandListener, addExportStrategy, addImportStrategy, addKeyListener, addMouseListener, addNotificationListener, addPreferenceProperty, applyTheme, applyTheme, dispatchInputEvent, exportTransfer, fireInputEvent, getAncestor, getComponentOrientation, getConstraints, getDepictor, getFlyoverStrategy, getInputStrategy, getName, getNotification, getOrientation, getParent, getPreferenceProperties, getTheme, hasCommandListeners, hasKeyListeners, hasMouseListeners, importTransfer, initialize, isDragEnabled, isDropEnabled, isFlyoverEnabled, isPreferenceProperty, isThemeApplied, isValid, loadPreferences, notify, removeCommandListener, removeExportStrategy, removeImportStrategy, removeKeyListener, removeMouseListener, removeNotificationListener, removePreferenceProperty, resetTheme, savePreferences, setConstraints, setDragEnabled, setDropEnabled, setFlyoverEnabled, setFlyoverStrategy, setInputStrategy, setName, setNotification, setOrientation, setParent, setThemeApplied, updateTheme

Methods inherited from interface com.guiseframework.platform.DepictedObject

depict, getDepictID, getSession, processEvent

Methods inherited from interface com.guiseframework.model.ui.PresentationModel

BorderLineFarColor, BorderLineFarExtent, BorderLineFarStyle, BorderLineNearColor, BorderLineNearExtent, BorderLineNearStyle, BorderPageFarColor, BorderPageFarExtent, BorderPageFarStyle, BorderPageNearColor, BorderPageNearExtent, BorderPageNearStyle, getBackgroundColor, getBorderColor, getBorderExtent, getBorderStyle, getCornerArcSize, getCornerLineFarPageFarArcSize, getCornerLineFarPageNearArcSize, getCornerLineNearPageFarArcSize, getCornerLineNearPageNearArcSize, getCursor, getExtent, getFontFamilies, getFontSize, getFontStyle, getFontWeight, getLabelFontFamilies, getLabelFontSize, getLabelFontStyle, getLabelFontWeight, getLabelTextColor, getLineExtent, getMarginExtent, getMarginLineFarExtent, getMarginLineNearExtent, getMarginPageFarExtent, getMarginPageNearExtent, getOpacity, getPaddingExtent, getPaddingLineFarExtent, getPaddingLineNearExtent, getPaddingPageFarExtent, getPaddingPageNearExtent, getPageExtent, getSession, getStyleID, getTextColor, isDisplayed, isTooltipEnabled, isVisible, setBackgroundColor, setBorderColor, setBorderColor, setBorderExtent, setBorderExtent, setBorderLineFarColor, setBorderLineFarExtent, setBorderLineFarStyle, setBorderLineNearColor, setBorderLineNearExtent, setBorderLineNearStyle, setBorderPageFarColor, setBorderPageFarExtent, setBorderPageFarStyle, setBorderPageNearColor, setBorderPageNearExtent, setBorderPageNearStyle, setBorderStyle, setBorderStyle, setCornerArcSize, setCornerArcSize, setCornerLineFarPageFarArcSize, setCornerLineFarPageNearArcSize, setCornerLineNearPageFarArcSize, setCornerLineNearPageNearArcSize, setCursor, setDisplayed, setExtent, setFontFamilies, setFontSize, setFontStyle, setFontWeight, setLabelFontFamilies, setLabelFontSize, setLabelFontStyle, setLabelFontWeight, setLabelTextColor, setLineExtent, setMarginExtent, setMarginExtent, setMarginLineFarExtent, setMarginLineNearExtent, setMarginPageFarExtent, setMarginPageNearExtent, setOpacity, setPaddingExtent, setPaddingExtent, setPaddingLineFarExtent, setPaddingLineNearExtent, setPaddingPageFarExtent, setPaddingPageNearExtent, setPageExtent, setStyleID, setTextColor, setTooltipEnabled, setVisible

Methods inherited from interface com.guiseframework.model.InfoModel

getDescription, getDescriptionContentType, getInfo, getInfoContentType, setDescription, setDescriptionContentType, setInfo, setInfoContentType

Methods inherited from interface com.guiseframework.model.LabelModel

getGlyphURI, getLabel, getLabelContentType, setGlyphURI, setLabel, setLabelContentType

Methods inherited from interface com.globalmentor.beans.PropertyBindable

addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, hasPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from interface com.globalmentor.beans.PropertyConstrainable

addVetoableChangeListener, addVetoableChangeListener, getVetoableChangeListeners, getVetoableChangeListeners, hasVetoableChangeListeners, removeVetoableChangeListener, removeVetoableChangeListener

Methods inherited from interface com.guiseframework.component.Control

getStatus

Methods inherited from interface com.guiseframework.model.Enableable

isEnabled, setEnabled

Field Detail

AUTO_COMMIT_PATTERN_PROPERTY

public static final java.lang.String AUTO_COMMIT_PATTERN_PROPERTY

The auto commit pattern bound property.

COLUMN_COUNT_PROPERTY

public static final java.lang.String COLUMN_COUNT_PROPERTY

The column count bound property.

PROVISIONAL_TEXT_PROPERTY

public static final java.lang.String PROVISIONAL_TEXT_PROPERTY

The provisional text literal bound property.

TEXT_PROPERTY

public static final java.lang.String TEXT_PROPERTY

The text literal bound property.

VALUE_CONTENT_TYPE_PROPERTY

public static final java.lang.String VALUE_CONTENT_TYPE_PROPERTY

The value content type bound property.

Constructor Detail

AbstractTextControl

public AbstractTextControl(java.lang.Class<V> valueClass)

Value class constructor with a default data model to represent a given type and a default converter.

Parameters:

valueClass - The class indicating the type of value held in the model.

Throws:

java.lang.NullPointerException - if the given value class is null.

AbstractTextControl

public AbstractTextControl(ValueModel<V> valueModel)

Value model constructor with a default converter.

Parameters:

valueModel - The component data model.

Throws:

java.lang.NullPointerException - if the given value model is null.

AbstractTextControl

public AbstractTextControl(ValueModel<V> valueModel,
                           Converter<V,java.lang.String> converter)

Value model and converter constructor.

Parameters:

valueModel - The component value model.

converter - The converter for this component.

Throws:

java.lang.NullPointerException - if the given value model and/or converter is null.

Method Detail

getAutoCommitPattern

public java.util.regex.Pattern getAutoCommitPattern()

Returns:

The regular expression pattern that will cause the text automatically to be committed immediately, or null if text should not be committed during entry.

setAutoCommitPattern

public void setAutoCommitPattern(java.util.regex.Pattern newAutoCommitPattern)

Sets the The regular expression pattern that will cause the text automatically to be committed immediately. This is a bound property.

Parameters:

newAutoCommitPattern - The regular expression pattern that will cause the text automatically to be committed immediately, or null if text should not be committed during entry.

See Also:

AUTO_COMMIT_PATTERN_PROPERTY

getColumnCount

public int getColumnCount()

Returns:

The estimated number of columns requested to be visible, or -1 if no column count is specified.

setColumnCount

public void setColumnCount(int newColumnCount)

Sets the estimated number of columns requested to be visible. This is a bound property of type Integer.

Parameters:

newColumnCount - The new requested number of visible columns, or -1 if no column count is specified.

See Also:

COLUMN_COUNT_PROPERTY

getConverter

public Converter<V,java.lang.String> getConverter()

Returns:

The converter for this component.

setConverter

public void setConverter(Converter<V,java.lang.String> newConverter)

Sets the converter. This is a bound property

Parameters:

newConverter - The converter for this component.

Throws:

java.lang.NullPointerException - if the given converter is null.

See Also:

ValueControl.CONVERTER_PROPERTY

getProvisionalText

public java.lang.String getProvisionalText()

Returns:

The provisional text literal value, or null if there is no provisional literal value.

setProvisionalText

public void setProvisionalText(java.lang.String newProvisionalText)

Sets the provisional text literal value. This method updates the valid status before firing a change event. This is a bound property.

Parameters:

newProvisionalText - The provisional text literal value.

See Also:

PROVISIONAL_TEXT_PROPERTY

getText

public java.lang.String getText()

Returns:

The text literal value displayed in the control, or null if there is no literal value.

setText

public void setText(java.lang.String newText)

Sets the text literal value displayed in the control. This method updates the provisional text to match and updates the valid status if needed. This is a bound property.

Parameters:

newText - The text literal value displayed in the control.

See Also:

TEXT_PROPERTY

setTextValue

public void setTextValue(java.lang.String newText)
                  throws ConversionException,
                         java.beans.PropertyVetoException

Sets the text literal value displayed in the control, and then converts the text to an appropriate value and stores it. This is a convenience method.

Parameters:

newText - The new text literal value to display in the control and then convert and store as a value.

Throws:

ConversionException - if the literal value cannot be converted.

java.beans.PropertyVetoException - if the provided value is not valid or the change has otherwise been vetoed.

See Also:

setText(String), getConverter(), Converter.convertLiteral(Object), AbstractValueControl.setValue(Object)

getValueContentType

public com.globalmentor.net.ContentType getValueContentType()

Returns:

The content type of the value.

setValueContentType

public void setValueContentType(com.globalmentor.net.ContentType newValueContentType)

Sets the content type of the value. This is a bound property.

Parameters:

newValueContentType - The new value content type.

Throws:

java.lang.NullPointerException - if the given content type is null.

java.lang.IllegalArgumentException - if the given content type is not a text content type.

See Also:

VALUE_CONTENT_TYPE_PROPERTY

updateText

protected void updateText()

Updates the component text with literal form of the given value.

See Also:

Converter.convertValue(Object), AbstractValueControl.getValue(), setText(String)

determineValid

protected boolean determineValid()

Checks the state of the component for validity. This version in addition to default functionality checks to make sure the literal text can be converted to a valid value. The provisional text is checked for validity, because it represents the latest available input from the user. This version performs no additional checks if the control is disabled.

Overrides:

determineValid in class AbstractValueControl<V>

Returns:

true if the component and all children passes all validity tests, else false.

See Also:

getProvisionalText()

determineStatus

protected Control.Status determineStatus()

Checks the user input status of the control. This version checks to see if the provisional literal text can be converted to a valid value. If the provisional literal text cannot be converted, the status is determined to be Status#ERROR. If the provisional literal text can be converted but the converted value is invalid, the status is determined to be Status#WARNING unless the provisional text is the same as the literal text, in which case the status is determined to be Status#ERROR. The default value, even if invalid, is considered valid. If the control is disabled no status is given.

Overrides:

determineStatus in class AbstractControl

Returns:

The current user input status of the control.

See Also:

getProvisionalText()

validate

public boolean validate()

Validates the user input of this component and all child components. The component will be updated with error information. This version also validates the literal text, committing the text to the model if necessary. This version performs no additional checks if the control is disabled.

Specified by:

validate in interface Component

Overrides:

validate in class AbstractValueControl<V>

Returns:

The current state of AbstractComponent.isValid() as a convenience.

reset

public void reset()

Resets the control to its default value. This version updates the text to match the new value.

Specified by:

reset in interface Control

Overrides:

reset in class AbstractValueControl<V>

See Also:

updateText()