Skip to main content
A newer version of this page is available. .
Tab

ASPxSpinEdit Class

Represents the spin edit control.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v19.2.dll

Declaration

public class ASPxSpinEdit :
    ASPxSpinEditBase,
    IAllowNullOwner

Remarks

The ASPxSpinEdit class represents an editor consisting of an edit region and one or two pairs of spin buttons which can be used to adjust the numerical value. This value is specified via the ASPxSpinEdit.Number property.

ASPxSpinEdit_control.png

The appearance and position of spin buttons can be controlled using the settings available via the ASPxSpinEdit.SpinButtons property.

When an end-user presses a small or large spin button, the ASPxSpinEdit.Number property’s value is incremented or decremented by the amount specified by the ASPxSpinEdit.Increment or ASPxSpinEdit.LargeIncrement property respectively. The value of the ASPxSpinEdit control can also be changed using mouse wheel and keyboard (the ARROW UP and ARROW DOWN keys - for small increment/decrement; the CTRL+ARROW UP and CTRL+ARROW DOWN or PAGE UP and PAGE DOWN keys - for large increment/decrement).

The ASPxSpinEdit.Number property’s value can be limited via the ASPxSpinEdit.MinValue and ASPxSpinEdit.MaxValue properties. Note, that these limitations are not applicable to the ASPxSpinEdit.Value property of the ASPxSpinEdit. The ASPxSpinEdit.Value property can be assigned a value that exceeds the specified limits, but editing can only be applied within these limits. If the ASPxSpinEdit.AllowNull property is set to true, the ASPxSpinEdit can accept null values.

The ASPxSpinEdit control can function in float or integer editing mode depending upon the ASPxSpinEdit.NumberType property’s setting. In integer mode, float value input is disabled and float values displayed within the editor are automatically rounded after they has been modified. In float mode, culture specific separators are supported, allowing decimal separators to display uniquely in various cultures. The number of decimal places can be defined using the ASPxSpinEdit.DecimalPlaces property.

Note

The client-side equivalent of this editor control is represented by the ASPxClientSpinEdit object. The client editor object can be accessed directly by the name specified via the ASPxEditBase.ClientInstanceName property. The editor’s client-side API is enabled if the ASPxEditBase.EnableClientSideAPI property is set to true, or any client event is handled. Available client events can be accessed via the ASPxSpinEdit.ClientSideEvents property.

See Also