com.smartgwt.mobile.client.widgets.form.fields

Class AbstractHasDataValue

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

com.google.gwt.user.client.ui.Panel

com.google.gwt.user.client.ui.ComplexPanel

com.smartgwt.mobile.client.widgets.Canvas

com.smartgwt.mobile.client.widgets.form.fields.AbstractHasDataValue

All Implemented Interfaces:

com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.HasWidgets, com.google.gwt.user.client.ui.HasWidgets.ForIsWidget, com.google.gwt.user.client.ui.IndexedPanel, com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget, com.google.gwt.user.client.ui.IsWidget, com.smartgwt.mobile.client.internal.test.AutoTestLocatable, com.smartgwt.mobile.client.internal.widgets.form.fields.CanCopyFieldConfiguration, HasClickHandlers, HasShowContextMenuHandlers, HasDataValue, java.lang.Iterable<com.google.gwt.user.client.ui.Widget>

Direct Known Subclasses:

FormItem

public abstract class AbstractHasDataValue
extends Canvas
implements HasDataValue, com.smartgwt.mobile.client.internal.widgets.form.fields.CanCopyFieldConfiguration

Provides a skeletal implementation of the HasDataValue interface, to minimize the effort required to implement this interface and also to minimize the impact of a change to the HasDataValue interface.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.IndexedPanel

com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.HasWidgets

com.google.gwt.user.client.ui.HasWidgets.ForIsWidget

Field Summary

Fields inherited from class com.smartgwt.mobile.client.widgets.Canvas

_CONTENT_CHANGED_EVENT_TYPE, _CSS, _HISTORY_ENABLED, _REQUEST_SCROLL_TO_EVENT_TYPE, id, touched

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractHasDataValue(java.lang.String fieldName)
protected	AbstractHasDataValue(java.lang.String fieldName, java.lang.String title)

Method Summary

Modifier and Type	Method and Description
void	_copyFieldConfiguration(DataSourceField field)
boolean	compareValues(java.lang.Object value1, java.lang.Object value2) Compares two values for equality.
java.lang.Boolean	getCanEdit()
DataManager	getDataManager()
java.lang.String	getFieldName() Returns this field's name.
protected java.lang.Boolean	getRealShowTitle()
java.lang.Boolean	getShowTitle() If null or Boolean.TRUE, then this field's title will be shown by the DynamicForm.
java.lang.Boolean	getStopOnError()
java.lang.String	getTitle() Returns this field's title.
Validator[]	getValidators()
void	setCanEdit(java.lang.Boolean canEdit) If non-null, explicitly sets the editability of this field.
void	setDataManager(DataManager dataManager) Sets the associated DataManager instance.
protected void	setFieldName(java.lang.String fieldName)
void	setShowTitle(java.lang.Boolean showTitle)
void	setStopOnError(java.lang.Boolean stopOnError)
void	setTitle(java.lang.String title)
void	setValidators(Validator... validators)
abstract void	showValue(java.lang.Object value) Called by the DataManager to notify this HasDataValue that the DataManager's value for this HasDataValue was changed and that this HasDataValue needs to update its display field to the given value.
void	updateCanEdit() Default implementation of HasDataValue.updateCanEdit().

Methods inherited from class com.smartgwt.mobile.client.widgets.Canvas

_add, _booleanValue, _fireContentChangedEvent, _fireContentChangedEvent, _fireRequestScrollToEvent, _getAndroidWindowSoftInputMode, _getAttributeFromSplitLocator, _getChildFromLocatorSubstring, _getFixNavigationBarPositionDuringKeyboardFocus, _getHideTabBarDuringKeyboardFocus, _getInnerAttributeFromSplitLocator, _getInnerElement, _hideAddressBar, _hideAddressBarNow, _insert, _isDifferent, _isHDPIDisplay, _isIOS4OrOlder, _isIOS5, _isIOSMin6_0, _isStandaloneMode, _nativeParseFloat, _removeClassName, _setClassName, _setHandleDisabled, _sinkAnimationEndEvent, _sinkContentChangedEvent, _sinkFocusInEvent, _sinkFocusOutEvent, _sinkInputEvent, _sinkRequestScrollToEvent, _sinkTransitionEndEvent, _triggerDebugger, addChild, addChild, addChild, addClickHandler, addShowContextMenuHandler, destroy, disable, enable, getContextMenu, getID, getInnerHTML, getMargin, hasChild, hasChild, isAndroid, isDisabled, isEnabled, isIPad, isIPhone, isSafari, isStandAlone, isUIWebView, onBrowserEvent, parseDimension, removeChild, removeChild, setContents, setContextMenu, setDisabled, setElement, setID, setMargin, setStyleName, split, useIOSNativeScrolling

Methods inherited from class com.google.gwt.user.client.ui.ComplexPanel

add, add, adjustIndex, checkIndexBoundsForAccess, checkIndexBoundsForInsertion, getChildren, getWidget, getWidgetCount, getWidgetIndex, getWidgetIndex, insert, insert, iterator, remove, remove

Methods inherited from class com.google.gwt.user.client.ui.Panel

add, add, adopt, clear, doAttachChildren, doDetachChildren, orphan, remove

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, fireEvent, getHandlerCount, getLayoutData, getParent, isAttached, isOrWasAttached, onAttach, onDetach, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, setVisible, setWidth, sinkBitlessEvent, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.gwt.event.shared.HasHandlers

fireEvent

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

AbstractHasDataValue

protected AbstractHasDataValue(java.lang.String fieldName)

AbstractHasDataValue

protected AbstractHasDataValue(java.lang.String fieldName,
                               java.lang.String title)

Method Detail

getCanEdit

public final java.lang.Boolean getCanEdit()

Specified by:

getCanEdit in interface HasDataValue

setCanEdit

public void setCanEdit(java.lang.Boolean canEdit)

Description copied from interface: HasDataValue

If non-null, explicitly sets the editability of this field. A value of Boolean.TRUE means that this field is editable. A value of Boolean.FALSE means that this field is read-only.

If not explicitly set, then this field should consider itself editable if its DataManager is editable. See DataManager.getCanEdit().

Specified by:

setCanEdit in interface HasDataValue

Parameters:

canEdit - an explicit override.

getDataManager

public final DataManager getDataManager()

setDataManager

public void setDataManager(DataManager dataManager)

Description copied from interface: HasDataValue

Sets the associated DataManager instance.

This HasDataValue instance uses the DataManager to post notifications of changes to its value caused by user action.

Specified by:

setDataManager in interface HasDataValue

Parameters:

dataManager - the associated DataManager.

See Also:

DataManager.storeValue(String, Object)

getFieldName

public final java.lang.String getFieldName()

Description copied from interface: HasDataValue

Returns this field's name.

Specified by:

getFieldName in interface HasDataValue

Returns:

this field's name.

setFieldName

protected void setFieldName(java.lang.String fieldName)

getRealShowTitle

protected final java.lang.Boolean getRealShowTitle()

getShowTitle

public java.lang.Boolean getShowTitle()

Description copied from interface: HasDataValue

If null or Boolean.TRUE, then this field's title will be shown by the DynamicForm.

Specified by:

getShowTitle in interface HasDataValue

Returns:

whether to show a title for this field.

setShowTitle

public void setShowTitle(java.lang.Boolean showTitle)

getStopOnError

public final java.lang.Boolean getStopOnError()

Specified by:

getStopOnError in interface HasDataValue

setStopOnError

public void setStopOnError(java.lang.Boolean stopOnError)

getTitle

public final java.lang.String getTitle()

Description copied from interface: HasDataValue

Returns this field's title.

Specified by:

getTitle in interface HasDataValue

Overrides:

getTitle in class com.google.gwt.user.client.ui.UIObject

Returns:

this field's title.

setTitle

public void setTitle(java.lang.String title)

Overrides:

setTitle in class com.google.gwt.user.client.ui.UIObject

getValidators

public final Validator[] getValidators()

Specified by:

getValidators in interface HasDataValue

setValidators

public void setValidators(Validator... validators)

compareValues

public boolean compareValues(java.lang.Object value1,
                             java.lang.Object value2)

Description copied from interface: HasDataValue

Compares two values for equality.

Specified by:

compareValues in interface HasDataValue

Parameters:

value1 - first value.

value2 - second value.

Returns:

true if value1 is equal to value2 in the context of this HasDataValue; false otherwise.

_copyFieldConfiguration

public void _copyFieldConfiguration(DataSourceField field)

Specified by:

_copyFieldConfiguration in interface com.smartgwt.mobile.client.internal.widgets.form.fields.CanCopyFieldConfiguration

showValue

public abstract void showValue(java.lang.Object value)

Description copied from interface: HasDataValue

Called by the DataManager to notify this HasDataValue that the DataManager's value for this HasDataValue was changed and that this HasDataValue needs to update its display field to the given value.

NOTE: An implementation must not call the associated DataManager's DataManager.storeValue(String, Object) method.

Specified by:

showValue in interface HasDataValue

Parameters:

value - the new value.

updateCanEdit

public void updateCanEdit()

Default implementation of HasDataValue.updateCanEdit(). If overridden, be sure to call super.updateCanEdit().

Specified by:

updateCanEdit in interface HasDataValue