com.sencha.gxt.widget.core.client.form

Class SpinnerField<N extends Number>

java.lang.Object

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

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

com.sencha.gxt.widget.core.client.Component

com.sencha.gxt.widget.core.client.cell.CellComponent<T>

com.sencha.gxt.widget.core.client.form.Field<T>

com.sencha.gxt.widget.core.client.form.ValueBaseField<T>

com.sencha.gxt.widget.core.client.form.TriggerField<T>

com.sencha.gxt.widget.core.client.form.TwinTriggerField<N>

com.sencha.gxt.widget.core.client.form.SpinnerField<N>

Type Parameters:

N - the numeric field type

All Implemented Interfaces:

Editor<N>, HasEditorDelegate<N>, HasEditorErrors<N>, LeafValueEditor<N>, ValueAwareEditor<N>, HasChangeHandlers, HasKeyDownHandlers, HasKeyPressHandlers, HasKeyUpHandlers, HasAttachHandlers, HasBeforeSelectionHandlers<N>, HasResizeHandlers, HasSelectionHandlers<N>, HasValueChangeHandlers<N>, HasHandlers, AutoDirectionHandler.Target, HasDirection, HasDirectionEstimator, EventListener, TakesValue<N>, HasEnabled, HasName, HasText, HasValue<N>, HasVisibility, IsWidget, HasKeyProvider<N>, BeforeHideEvent.HasBeforeHideHandlers, BeforeShowContextMenuEvent.HasBeforeShowContextMenuHandler, BeforeShowEvent.HasBeforeShowHandlers, BlurEvent.HasBlurHandlers, DisableEvent.HasDisableHandlers, EnableEvent.HasEnableHandlers, FocusEvent.HasFocusHandlers, HideEvent.HasHideHandlers, InvalidEvent.HasInvalidHandlers, MoveEvent.HasMoveHandlers, ParseErrorEvent.HasParseErrorHandlers, ShowContextMenuEvent.HasShowContextMenuHandler, ShowEvent.HasShowHandlers, TriggerClickEvent.HasTriggerClickHandlers, TwinTriggerClickEvent.HasTwinTriggerClickHandlers, ValidEvent.HasValidHandlers, HasErrorHandler, IsField<N>, HasFocusSupport, HasItemId

Direct Known Subclasses:

BigDecimalSpinnerField, BigIntegerSpinnerField, DoubleSpinnerField, FloatSpinnerField, IntegerSpinnerField, LongSpinnerField, ShortSpinnerField

public class SpinnerField<N extends Number>
extends TwinTriggerField<N>
implements HasBeforeSelectionHandlers<N>, HasSelectionHandlers<N>

A single line input field with up / down arrows that enable incrementing / decrementing a numeric value. A spinner field uses a number property editor to increment, decrement and format the value. See the nested classes at NumberPropertyEditor for number property editors you can use with spinner field.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SpinnerField.SpinnerMessages The locale-sensitive messages used by this class.

Nested classes/interfaces inherited from class com.sencha.gxt.widget.core.client.form.Field

Field.FieldStyles

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

UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled

Nested classes/interfaces inherited from interface com.google.gwt.i18n.client.HasDirection

HasDirection.Direction

Field Summary

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

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
SpinnerField(NumberPropertyEditor<N> editor) Creates a spinner field with the specified property editor.
SpinnerField(SpinnerFieldCell<N> cell) Creates a spinner field with the specified cell.

Method Summary

Methods

Modifier and Type	Method and Description
HandlerRegistration	addBeforeSelectionHandler(BeforeSelectionHandler<N> handler)
HandlerRegistration	addSelectionHandler(SelectionHandler<N> handler)
SpinnerFieldCell<N>	getCell() Get the Cell wrapped by this widget.
Number	getIncrement(Cell.Context context) Sets the increment value.
Number	getMaxValue() Returns the fields max value.
SpinnerField.SpinnerMessages	getMessages() Returns the locale-sensitive messages used by this class.
Number	getMinValue() Returns the field's minimum value.
NumberPropertyEditor<N>	getPropertyEditor() Returns the field's property editor.
boolean	isAllowDecimals() Returns true of decimal values are allowed.
boolean	isAllowNegative() Returns true if negative values are allowed.
void	setAllowDecimals(boolean allowDecimals) Sets whether decimal value are allowed (defaults to true).
void	setAllowNegative(boolean allowNegative) Sets whether negative value are allowed.
void	setIncrement(N increment) Sets the increment that should be used (defaults to 1d).
void	setMaxValue(N maxValue) Sets the field's max allowable value.
void	setMessages(SpinnerField.SpinnerMessages messages) Sets the spinner field messages.
void	setMinValue(Number minValue) Sets the field's minimum allowed value.

Methods inherited from class com.sencha.gxt.widget.core.client.form.TwinTriggerField

addTwinTriggerClickHandler

Methods inherited from class com.sencha.gxt.widget.core.client.form.TriggerField

addTriggerClickHandler, isEditable, isFinishEditOnEnter, isMonitorTab, setEditable, setFinishEditOnEnter, setHideTrigger, setMonitorTab

Methods inherited from class com.sencha.gxt.widget.core.client.form.ValueBaseField

addChangeHandler, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addParseErrorHandler, clear, getCurrentValue, getCursorPos, getDirection, getDirectionEstimator, getEmptyText, getSelectedText, getSelectionLength, getText, getValueOrThrow, isAllowBlank, isClearValueOnParseError, isCurrentValid, isCurrentValid, isReadOnly, isSelectOnFocus, select, selectAll, setAllowBlank, setClearValueOnParseError, setCursorPos, setDirection, setDirectionEstimator, setDirectionEstimator, setEmptyText, setId, setPropertyEditor, setReadOnly, setSelectionRange, setSelectOnFocus, setTabIndex, setText, setValue, validateCurrent

Methods inherited from class com.sencha.gxt.widget.core.client.form.Field

addInvalidHandler, addValidator, addValidHandler, addValueChangeHandler, clearInvalid, finishEditing, flush, forceInvalid, getErrors, getErrorSupport, getName, getOriginalValue, getValidateOnBlur, getValidationDelay, getValidators, isAutoValidate, isEditing, isValid, isValid, markInvalid, onBrowserEvent, onPropertyChange, removeValidator, reset, setAutoValidate, setDelegate, setErrorSupport, setName, setOriginalValue, setValidateOnBlur, setValidationDelay, setValue, showErrors, validate, validate

Methods inherited from class com.sencha.gxt.widget.core.client.cell.CellComponent

getElement, getKeyProvider, getValue, redraw, setValue

Methods inherited from class com.sencha.gxt.widget.core.client.Component

addBeforeHideHandler, addBeforeShowContextMenuHandler, addBeforeShowHandler, addBlurHandler, addDisableHandler, addEnableHandler, addFocusHandler, addHideHandler, addMoveHandler, addResizeHandler, addShowContextMenuHandler, addShowHandler, addStyleOnOver, clearSizeCache, disable, disableEvents, enable, enableEvents, fireEvent, focus, getData, getFocusSupport, getHideMode, getId, getItemId, getOffsetHeight, getOffsetWidth, getShadow, getShadowPosition, getStateId, getTabIndex, getToolTip, hide, hideToolTip, isAllowTextSelection, isAutoHeight, isAutoWidth, isDeferHeight, isEnabled, isRendered, isStateful, isVisible, isVisible, mask, mask, removeToolTip, setAllowTextSelection, setBorders, setBounds, setBounds, setContextMenu, setData, setDeferHeight, setEnabled, setHeight, setHeight, setHideMode, setItemId, setPagePosition, setPixelSize, setPosition, setShadow, setShadowPosition, setSize, setStateful, setStateId, setToolTip, setToolTip, setToolTipConfig, setVisible, setWidth, setWidth, show, sync, syncSize, unmask

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

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, getLayoutData, getParent, isAttached, removeFromParent, setLayoutData, sinkEvents, unsinkEvents

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

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getOffsetHeight, getOffsetWidth, getStyleName, getStylePrimaryName, getTitle, isVisible, removeStyleDependentName, removeStyleName, setStyleDependentName, setStyleName, setStyleName, setStylePrimaryName, setTitle, setVisible, sinkBitlessEvent, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

fireEvent

Methods inherited from interface com.google.gwt.user.client.ui.IsWidget

asWidget

Methods inherited from interface com.google.gwt.user.client.TakesValue

getValue

Methods inherited from interface com.sencha.gxt.widget.core.client.event.BlurEvent.HasBlurHandlers

addBlurHandler

Methods inherited from interface com.google.gwt.user.client.ui.HasValue

getValue, setValue

Constructor Detail

SpinnerField

public SpinnerField(NumberPropertyEditor<N> editor)

Creates a spinner field with the specified property editor.

Parameters:

editor - the property editor that increments, decrements and formats the value.

SpinnerField

public SpinnerField(SpinnerFieldCell<N> cell)

Creates a spinner field with the specified cell.

Parameters:

cell - a numeric cell with up / down arrows that increment / decrement the value

Method Detail

addBeforeSelectionHandler

public HandlerRegistration addBeforeSelectionHandler(BeforeSelectionHandler<N> handler)

Specified by:

addBeforeSelectionHandler in interface HasBeforeSelectionHandlers<N extends Number>

addSelectionHandler

public HandlerRegistration addSelectionHandler(SelectionHandler<N> handler)

Specified by:

addSelectionHandler in interface HasSelectionHandlers<N extends Number>

getCell

public SpinnerFieldCell<N> getCell()

Description copied from class: CellComponent

Get the Cell wrapped by this widget.

Overrides:

getCell in class TriggerField<N extends Number>

Returns:

the Cell being wrapped

getIncrement

public Number getIncrement(Cell.Context context)

Sets the increment value.

Returns:

the increment

getMaxValue

public Number getMaxValue()

Returns the fields max value.

Returns:

the max value

getMessages

public SpinnerField.SpinnerMessages getMessages()

Returns the locale-sensitive messages used by this class.

Returns:

the local-sensitive messages used by this class.

getMinValue

public Number getMinValue()

Returns the field's minimum value.

Returns:

the min value

getPropertyEditor

public NumberPropertyEditor<N> getPropertyEditor()

Description copied from class: ValueBaseField

Returns the field's property editor.

Overrides:

getPropertyEditor in class ValueBaseField<N extends Number>

Returns:

the property editor

isAllowDecimals

public boolean isAllowDecimals()

Returns true of decimal values are allowed.

Returns:

the allow decimal state

isAllowNegative

public boolean isAllowNegative()

Returns true if negative values are allowed.

Returns:

the allow negative value state

setAllowDecimals

public void setAllowDecimals(boolean allowDecimals)

Sets whether decimal value are allowed (defaults to true).

Parameters:

allowDecimals - true to allow negative values

setAllowNegative

public void setAllowNegative(boolean allowNegative)

Sets whether negative value are allowed.

Parameters:

allowNegative - true to allow negative values

setIncrement

public void setIncrement(N increment)

Sets the increment that should be used (defaults to 1d).

Parameters:

increment - the increment to set.

setMaxValue

public void setMaxValue(N maxValue)

Sets the field's max allowable value.

Parameters:

maxValue - the max value

setMessages

public void setMessages(SpinnerField.SpinnerMessages messages)

Sets the spinner field messages.

Parameters:

messages - the messages

setMinValue

public void setMinValue(Number minValue)

Sets the field's minimum allowed value.

Parameters:

minValue - the minimum value