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

Class SelectItem

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

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

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

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

All Implemented Interfaces:

com.google.gwt.event.dom.client.HasKeyPressHandlers, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.EventHandler, 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.events.HasValuesSelectedHandlers, com.smartgwt.mobile.client.internal.widgets.events.ValuesSelectedHandler, com.smartgwt.mobile.client.internal.widgets.form.fields.CanCopyFieldConfiguration, HasClickHandlers, HasShowContextMenuHandlers, HasBlurHandlers, HasChangedHandlers, HasDataValue, PickList, java.lang.Iterable<com.google.gwt.user.client.ui.Widget>

Direct Known Subclasses:

ColorPickerItem

public class SelectItem
extends TextItem
implements PickList

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

Constructor and Description
SelectItem(java.lang.String name)
SelectItem(java.lang.String name, java.lang.String title)
SelectItem(java.lang.String name, java.lang.String title, java.lang.String hint)

Method Summary

Modifier and Type	Method and Description
protected com.smartgwt.mobile.client.internal.widgets.Picker2	_createPicker()
boolean	_getAllowEmptyValue()
boolean	_getDefaultToFirstOption()
java.lang.Object	_getFirstOptionValue()
boolean	_isPickerEnabled()
void	_setElementReadOnly(boolean readOnly)
void	fetchData()
void	fetchData(DSCallback dsCallback)
java.lang.Boolean	getAllowEmptyValue()
java.lang.Boolean	getDefaultToFirstOption()
java.lang.String	getOptionOperationId()
java.lang.String	getPickListBaseStyle()
Criteria	getPickListCriteria() Returns the Criteria used to make fetches if data-bound.
ListGridField[]	getPickListFields()
protected Criteria	getPickListFilterCriteria() Returns a set of filter criteria to be applied to the data displayed in the PickList when it is shown.
Record	getSelectedRecord()
void	setAllowEmptyValue(java.lang.Boolean allowEmptyValue)
void	setDefaultToFirstOption(java.lang.Boolean defaultToFirstOption)
void	setEmptyDisplayValue(java.lang.String emptyDisplayValue)
void	setOptionDataSource(DataSource ds)
void	setOptionOperationId(java.lang.String optionOperationId)
void	setPickListBaseStyle(java.lang.String pickListBaseStyle)
void	setPickListCriteria(Criteria criteria)
void	setPickListFields(ListGridField... pickListFields)
void	setValueField(java.lang.String valueField)
void	setValueMap(java.util.LinkedHashMap<?,java.lang.String> valueMap) Set the valueMap for this item.
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.

Methods inherited from class com.smartgwt.mobile.client.widgets.form.fields.TextItem

_getShowHintInField, _nativeElementBlur, _shouldApplyStaticTypeFormat, getShowHintInField, getTextBoxStyle, getValueAsString, onBrowserEvent, setBrowserInputType, setTextBoxStyle, validate

Methods inherited from class com.smartgwt.mobile.client.widgets.form.fields.FormItem

_addValuesSelectedHandler, _checkForEditorExit, _copyFieldConfiguration, _elementBlur, _formatDataType, _getChildFromLocatorSubstring, _getDateFormatter, _getDatetimeFormatter, _getDefaultValue, _getDisplayValue, _getEmptyDisplayValue, _getInnerAttributeFromSplitLocator, _getInputElement, _getMultipleValueSeparator, _getPicker, _getRequired, _getShowHint, _getTimeFormatter, _getValueMap, _handleEditorExit, _handleInput, _isReadOnly, _isSetToDefaultValue, _mapDisplayToValue, _mapKey, _mapValueToDisplay, _onEnd, _onStart, _onValuesSelected, _parseDisplayValue, _refreshDisplayValue, _setElementValue, _storeValue, _unmapKey, _updateDateFormatter, _updateValue, _updateValue, addBlurHandler, addChangedHandler, addKeyPressHandler, getCriterion, getDateFormatter, getDatetimeFormatter, getDisplayField, getDisplayFieldName, getEditorValueFormatter, getEditorValueParser, getEmptyDisplayValue, getForm, getHint, getName, getOptionDataSource, getRequired, getShowHint, getTextAlign, getTimeFormatter, getValue, getValueField, getValueFieldName, getValueFormatter, onChanged, onUnload, setDataManager, setDateFormatter, setDatetimeFormatter, setDefaultValue, setDisplayField, setEditorValueFormatter, setEditorValueParser, setElement, setFieldName, setHint, setName, setRequired, setShowHint, setTextAlign, setTimeFormatter, setValue, setValue, setValueFormatter, setValueMap, showPicker, updateCanEdit

Methods inherited from class com.smartgwt.mobile.client.widgets.form.fields.AbstractHasDataValue

compareValues, getCanEdit, getDataManager, getFieldName, getRealShowTitle, getShowTitle, getStopOnError, getTitle, getValidators, setCanEdit, setShowTitle, setStopOnError, setTitle, setValidators

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

_add, _booleanValue, _fireContentChangedEvent, _fireContentChangedEvent, _fireRequestScrollToEvent, _getAndroidWindowSoftInputMode, _getAttributeFromSplitLocator, _getFixNavigationBarPositionDuringKeyboardFocus, _getHideTabBarDuringKeyboardFocus, _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, parseDimension, removeChild, removeChild, setContents, setContextMenu, setDisabled, 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, 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.smartgwt.mobile.client.widgets.form.fields.PickList

getDisplayField, getDisplayFieldName, getOptionDataSource, getValueField, getValueFieldName, setDisplayField

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

fireEvent

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

SelectItem

public SelectItem(java.lang.String name)

SelectItem

public SelectItem(java.lang.String name,
                  java.lang.String title)

SelectItem

public SelectItem(java.lang.String name,
                  java.lang.String title,
                  java.lang.String hint)

Method Detail

getAllowEmptyValue

public final java.lang.Boolean getAllowEmptyValue()

_getAllowEmptyValue

@SGWTInternal
public final boolean _getAllowEmptyValue()

setAllowEmptyValue

public void setAllowEmptyValue(java.lang.Boolean allowEmptyValue)

getDefaultToFirstOption

public final java.lang.Boolean getDefaultToFirstOption()

_getDefaultToFirstOption

@SGWTInternal
public final boolean _getDefaultToFirstOption()

setDefaultToFirstOption

public void setDefaultToFirstOption(java.lang.Boolean defaultToFirstOption)

_setElementReadOnly

@SGWTInternal
public void _setElementReadOnly(boolean readOnly)

Overrides:

_setElementReadOnly in class TextItem

setEmptyDisplayValue

public void setEmptyDisplayValue(java.lang.String emptyDisplayValue)

Overrides:

setEmptyDisplayValue in class FormItem

_getFirstOptionValue

@SGWTInternal
public java.lang.Object _getFirstOptionValue()

setOptionDataSource

public void setOptionDataSource(DataSource ds)

Specified by:

setOptionDataSource in interface PickList

Overrides:

setOptionDataSource in class FormItem

getOptionOperationId

public final java.lang.String getOptionOperationId()

setOptionOperationId

public void setOptionOperationId(java.lang.String optionOperationId)

getPickListBaseStyle

public java.lang.String getPickListBaseStyle()

Specified by:

getPickListBaseStyle in interface PickList

setPickListBaseStyle

public void setPickListBaseStyle(java.lang.String pickListBaseStyle)

Specified by:

setPickListBaseStyle in interface PickList

getPickListCriteria

public final Criteria getPickListCriteria()

Returns the Criteria used to make fetches if data-bound.

If this item has a data-bound PickList (for example optionDataSource is set), this can be used to provide static filter criteria when retrieving the data for the PickList.

Specified by:

getPickListCriteria in interface PickList

setPickListCriteria

public void setPickListCriteria(Criteria criteria)

Specified by:

setPickListCriteria in interface PickList

getPickListFields

public final ListGridField[] getPickListFields()

setPickListFields

public void setPickListFields(ListGridField... pickListFields)

getPickListFilterCriteria

protected Criteria getPickListFilterCriteria()

Returns a set of filter criteria to be applied to the data displayed in the PickList when it is shown.

If this is a data-bound item the criteria will be passed as criteria to DataSource.fetchData(). By default returns pickListCriteria if specified, otherwise an empty set of criteria so all records will be displayed.

NOTE: This is an override point - if overridden this method will be called by the live form item during filtering.

getSelectedRecord

public final Record getSelectedRecord()

setValueField

public void setValueField(java.lang.String valueField)

Specified by:

setValueField in interface PickList

Overrides:

setValueField in class FormItem

setValueMap

public void setValueMap(java.util.LinkedHashMap<?,java.lang.String> valueMap)

Description copied from class: FormItem

Set the valueMap for this item.

Note: the keys of valueMap must be normalized according to the rules applied by ObjectUtil.normalize(Object).

Overrides:

setValueMap in class FormItem

Parameters:

valueMap - the value map.

_createPicker

protected com.smartgwt.mobile.client.internal.widgets.Picker2 _createPicker()

Overrides:

_createPicker in class FormItem

fetchData

public void fetchData()

fetchData

public void fetchData(DSCallback dsCallback)

_isPickerEnabled

public boolean _isPickerEnabled()

Overrides:

_isPickerEnabled in class FormItem

showValue

public 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

Overrides:

showValue in class FormItem

Parameters:

value - the new value.