com.sencha.gxt.widget.core.client.form
Class NumberField<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.NumberField<N>

Type Parameters:

N - the number type

All Implemented Interfaces:

Editor<N>, HasEditorDelegate<N>, HasEditorErrors<N>, LeafValueEditor<N>, ValueAwareEditor<N>, HasChangeHandlers, HasKeyDownHandlers, HasKeyPressHandlers, HasKeyUpHandlers, HasAttachHandlers, HasResizeHandlers, HasValueChangeHandlers<N>, HasHandlers, AutoDirectionHandler.Target, HasDirection, HasDirectionEstimator, EventListener, TakesValue<N>, 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, IsField<N>, HasFocusSupport, HasItemId

public class NumberField<N extends Number>
extends TwinTriggerField<N>

A numeric text field that provides automatic keystroke filtering to disallow non-numeric characters, and numeric validation to limit the value to a range of valid numbers.

A NumberPropertyEditor must be passed at construction which is used to convert strings to typed number and from typed numbers to strings.

Nested Class Summary

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

NumberField(NumberInputCell<N> cell, NumberPropertyEditor<N> editor)
Creates a new number field.

NumberField(NumberPropertyEditor<N> editor)
Creates a new number field.

Method Summary

String	getBaseChars() Returns the base characters.
NumberInputCell<N>	getCell() Get the Cell wrapped by this widget.
String	getDecimalSeparator() Returns the decimal separator.
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 to be entered into the field (defaults to true).
void	setBaseChars(String baseChars) Sets the base set of characters to evaluate as valid numbers (defaults to '0123456789').
void	setDecimalSeparator(String decimalSeparator) Sets the decimal separator (defaults to LocaleInfo.getCurrentLocale().getNumberConstants().decimalSeparator()).
void	setFormat(NumberFormat format) Sets the cell's number formatter.

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, isMonitorTab, setEditable, setHideTrigger, setMonitorTab

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

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

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

addInvalidHandler, addValidator, addValidHandler, addValueChangeHandler, clear, clearInvalid, finishEditing, flush, forceInvalid, getErrorSupport, getName, getValidateOnBlur, getValidationDelay, getValidators, isAutoValidate, isEditing, isReadOnly, 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, getStateId, 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, setSize, setStateful, setStateId, setTabIndex, 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

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, unsinkEvents

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.google.gwt.user.client.ui.HasValue

getValue, setValue

Constructor Detail

NumberField

public NumberField(NumberInputCell<N> cell,
                   NumberPropertyEditor<N> editor)

Creates a new number field.

Parameters:

cell - the number input cell

editor - the property editor

NumberField

@UiConstructor
public NumberField(NumberPropertyEditor<N> editor)

Creates a new number field.

Parameters:

editor - the property editor

Method Detail

getBaseChars

public String getBaseChars()

Returns the base characters.

Returns:

the base characters

getCell

public NumberInputCell<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

getDecimalSeparator

public String getDecimalSeparator()

Returns the decimal separator.

Returns:

the decimal separator

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 decimal values

setAllowNegative

public void setAllowNegative(boolean allowNegative)

Sets whether negative value are allowed to be entered into the field (defaults to true).

Setting this does not add validation for negative values, use MinNumberValidator for that.

Parameters:

allowNegative - true to allow negative values

setBaseChars

public void setBaseChars(String baseChars)

Sets the base set of characters to evaluate as valid numbers (defaults to '0123456789').

Parameters:

baseChars - the base characters

setDecimalSeparator

public void setDecimalSeparator(String decimalSeparator)

Sets the decimal separator (defaults to LocaleInfo.getCurrentLocale().getNumberConstants().decimalSeparator()).

Parameters:

decimalSeparator - the decimal separator

setFormat

public void setFormat(NumberFormat format)

Sets the cell's number formatter.

Parameters:

format - the format