org.zkoss.zul
Class Doublespinner

java.lang.Object
  extended by org.zkoss.zk.ui.AbstractComponent
      extended by org.zkoss.zk.ui.HtmlBasedComponent
          extended by org.zkoss.zul.impl.XulElement
              extended by org.zkoss.zul.impl.InputElement
                  extended by org.zkoss.zul.impl.FormatInputElement
                      extended by org.zkoss.zul.impl.NumberInputElement
                          extended by org.zkoss.zul.Doublespinner
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, Component, Disable, Readonly, Scope, ComponentCtrl, Constrainted

public class Doublespinner
extends NumberInputElement

An edit box for holding a constrained double.

Default getZclass(): z-doublespinner.

doublespinner supports below key events.

  • 0-9 : set the value on the inner text box.
  • delete : clear the value to empty (null)

    Since:
    5.0.6
    Author:
    jumperchen
    See Also:
    Serialized Form

    Nested Class Summary
     
    Nested classes/interfaces inherited from class org.zkoss.zk.ui.HtmlBasedComponent
    HtmlBasedComponent.ExtraCtrl
     
    Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent
    AbstractComponent.Children
     
    Field Summary
     
    Fields inherited from class org.zkoss.zul.impl.InputElement
    _value
     
    Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent
    _zclass
     
    Fields inherited from interface org.zkoss.zk.ui.Component
    APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE
     
    Fields inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl
    CE_BUSY_IGNORE, CE_DUPLICATE_IGNORE, CE_IMPORTANT, CE_NON_DEFERRABLE, CE_REPEAT_IGNORE
     
    Constructor Summary
    Doublespinner()
               
    Doublespinner(double value)
               
     
    Method Summary
    protected  java.lang.Object coerceFromString(java.lang.String value)
              Coerces the value passed to InputElement.setText(java.lang.String).
    protected  java.lang.String coerceToString(java.lang.Object value)
              Coerces the value passed to InputElement.setText(java.lang.String).
     double doubleValue()
              Returns the value in double.
     double getStep()
              Return the step of double spinner
     java.lang.Double getValue()
              Returns the value (in Double), might be null unless a constraint stops it.
     java.lang.String getZclass()
              Returns the ZK Cascading Style class(es) for this component.
     boolean isButtonVisible()
              Returns whether the button (on the right of the textbox) is visible.
    protected  void renderProperties(ContentRenderer renderer)
              Renders the content of this component, excluding the enclosing tags and children.
     void setButtonVisible(boolean visible)
              Sets whether the button (on the right of the textbox) is visible.
     void setConstraint(java.lang.String constr)
               
     void setStep(double step)
              Set the step of double spinner
     void setValue(java.lang.Double value)
              Sets the value (in Double).
    protected  java.lang.Object unmarshall(java.lang.Object value)
              Unmarshall value returned from client if needed.
     
    Methods inherited from class org.zkoss.zul.impl.NumberInputElement
    formatNumber, getDefaultFormat, getDefaultLocale, getLocale, getRoundingMode, setLocale, setLocale, setRoundingMode, setRoundingMode, toNumberOnly
     
    Methods inherited from class org.zkoss.zul.impl.FormatInputElement
    getFormat, getRealFormat, setFormat
     
    Methods inherited from class org.zkoss.zul.impl.InputElement
    checkUserError, clearErrorMessage, clearErrorMessage, clone, getCols, getConstraint, getErrorMessage, getInstant, getMaxlength, getName, getPlaceholder, getRawText, getRawValue, getTabindex, getTargetValue, getText, getType, isChildable, isDisabled, isInplace, isMultiline, isReadonly, isValid, marshall, onWrongValue, select, service, setCols, setConstraint, setDisabled, setErrorMessage, setInplace, setInstant, setMaxlength, setName, setPlaceholder, setRawValue, setReadonly, setSelectedText, setSelectionRange, setTabindex, setText, setValueDirectly, showCustomError, validate
     
    Methods inherited from class org.zkoss.zul.impl.XulElement
    getContext, getCtrlKeys, getPopup, getTooltip, setContext, setContext, setCtrlKeys, setPopup, setPopup, setTooltip, setTooltip
     
    Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent
    focus, getAction, getDraggable, getDroppable, getExtraCtrl, getHeight, getHflex, getLeft, getRenderdefer, getSclass, getStyle, getTooltiptext, getTop, getVflex, getWidth, getZindex, getZIndex, setAction, setClass, setDraggable, setDroppable, setFocus, setHeight, setHeightDirectly, setHflex, setHflexDirectly, setLeft, setLeftDirectly, setRenderdefer, setSclass, setStyle, setTooltiptext, setTop, setTopDirectly, setVflex, setWidth, setWidthDirectly, setZclass, setZindex, setZIndex, setZIndexDirectly
     
    Methods inherited from class org.zkoss.zk.ui.AbstractComponent
    addAnnotation, addAnnotation, addClientEvent, addEventHandler, addEventListener, addEventListener, addForward, addForward, addForward, addForward, addMoved, addScopeListener, addSharedEventHandlerMap, appendChild, applyProperties, beforeChildAdded, beforeChildRemoved, beforeParentChanged, detach, didActivate, didActivate, didDeserialize, didDeserialize, disableClientUpdate, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttribute, getAttributeOrFellow, getAttributes, getAttributes, getAuService, getAutag, getChildren, getClientEvents, getDefaultMold, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getEventListenerMap, getEventListeners, getFellow, getFellow, getFellowIfAny, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNextSibling, getPage, getParent, getPreviousSibling, getRoot, getSpaceOwner, getStubonly, getTemplate, getTemplateNames, getUuid, getWidgetAttribute, getWidgetAttributeNames, getWidgetClass, getWidgetListener, getWidgetListenerNames, getWidgetOverride, getWidgetOverrideNames, hasAttribute, hasAttribute, hasAttribute, hasAttributeOrFellow, hasFellow, hasFellow, insertBefore, invalidate, isInvalidated, isListenerAvailable, isVisible, onChildAdded, onChildRemoved, onPageAttached, onPageDetached, query, queryAll, redraw, redrawChildren, removeAttribute, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, removeScopeListener, render, render, render, replace, response, response, response, service, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setAttribute, setAuService, setAutag, setDefinition, setDefinition, setId, setMold, setPage, setPageBefore, setParent, setStubonly, setStubonly, setTemplate, setVisible, setVisibleDirectly, setWidgetAttribute, setWidgetClass, setWidgetListener, setWidgetOverride, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdateWidgetListener, smartUpdateWidgetOverride, toString, updateByClient, willPassivate, willPassivate, willSerialize, willSerialize
     
    Methods inherited from class java.lang.Object
    finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
     

    Constructor Detail

    Doublespinner

    public Doublespinner()

    Doublespinner

    public Doublespinner(double value)
                  throws WrongValueException
    Throws:
    WrongValueException
    Method Detail

    getValue

    public java.lang.Double getValue()
                              throws WrongValueException
    Returns the value (in Double), might be null unless a constraint stops it.

    Throws:
    WrongValueException - if user entered a wrong value

    doubleValue

    public double doubleValue()
                       throws WrongValueException
    Returns the value in double. If null, zero is returned.

    Throws:
    WrongValueException

    setValue

    public void setValue(java.lang.Double value)
                  throws WrongValueException
    Sets the value (in Double).

    Throws:
    WrongValueException - if value is wrong

    getStep

    public double getStep()
    Return the step of double spinner


    setStep

    public void setStep(double step)
    Set the step of double spinner


    isButtonVisible

    public boolean isButtonVisible()
    Returns whether the button (on the right of the textbox) is visible.

    Default: true.


    setButtonVisible

    public void setButtonVisible(boolean visible)
    Sets whether the button (on the right of the textbox) is visible.


    getZclass

    public java.lang.String getZclass()
    Description copied from class: HtmlBasedComponent
    Returns the ZK Cascading Style class(es) for this component. It usually depends on the implementation of the mold (@{link #getMold}).

    Default: null (the default value depends on element).

    HtmlBasedComponent.setZclass(java.lang.String)) will completely replace the default style of a component. In other words, the default style of a component is associated with the default value of HtmlBasedComponent.getZclass(). Once it is changed, the default style won't be applied at all. If you want to perform small adjustments, use HtmlBasedComponent.setSclass(java.lang.String) instead.

    Overrides:
    getZclass in class HtmlBasedComponent
    See Also:
    HtmlBasedComponent.getSclass()

    setConstraint

    public void setConstraint(java.lang.String constr)
    Overrides:
    setConstraint in class InputElement
    Parameters:
    constr - a list of constraints separated by comma. Example: no positive, no zero

    coerceFromString

    protected java.lang.Object coerceFromString(java.lang.String value)
                                         throws WrongValueException
    Description copied from class: InputElement
    Coerces the value passed to InputElement.setText(java.lang.String).

    Deriving note:
    If you want to store the value in other type, say BigDecimal, you have to override InputElement.coerceToString(java.lang.Object) and InputElement.coerceFromString(java.lang.String) to convert between a string and your targeting type.

    Moreover, when Textbox is called, it calls this method with value = null. Derives shall handle this case properly.

    Specified by:
    coerceFromString in class InputElement
    Throws:
    WrongValueException

    coerceToString

    protected java.lang.String coerceToString(java.lang.Object value)
    Description copied from class: InputElement
    Coerces the value passed to InputElement.setText(java.lang.String).

    Default: convert null to an empty string.

    Deriving note:
    If you want to store the value in other type, say BigDecimal, you have to override InputElement.coerceToString(java.lang.Object) and InputElement.coerceFromString(java.lang.String) to convert between a string and your targeting type.

    Specified by:
    coerceToString in class InputElement

    unmarshall

    protected java.lang.Object unmarshall(java.lang.Object value)
    Description copied from class: InputElement
    Unmarshall value returned from client if needed.

    Overrides it if the value returned is not JSON Compatible.

    Overrides:
    unmarshall in class InputElement
    Parameters:
    value - the value returned from client
    Returns:
    the unmarshalled value

    renderProperties

    protected void renderProperties(ContentRenderer renderer)
                             throws java.io.IOException
    Description copied from class: HtmlBasedComponent
    Renders the content of this component, excluding the enclosing tags and children.

    See also ZK Client-side Reference: Property Rendering

    Overrides:
    renderProperties in class NumberInputElement
    Throws:
    java.io.IOException


    Copyright © 2005-2011 Potix Corporation. All Rights Reserved. SourceForge.net Logo