SpinEdit enables your end-users to edit numeric values with ease. The editor consists of an edit region and one or two pairs of spin buttons that can be used to adjust the numerical value.
To learn more about SpinEdit and see it in action, refer to our online demos.
SpinEdit is realized by the SpinEditExtension class. Its instance can be accessed via the ExtensionsFactory.SpinEdit helper method, which is used to add a SpinEdit extension to a view. This method's parameter provides access to the SpinEdit's settings implemented by the SpinEditSettings class, allowing you to fully customize the extension.
The SpinEdit supports the float and integer editing modes that are controlled by the SpinEditSettings.Properties.NumberType (SpinEditProperties.NumberType) property. In an integer mode (when the NumberType property is set to Integer), float value input is disabled and float values displayed within the editor are automatically rounded after they have been modified. In a float mode, culture specific separators are supported, allowing decimal separators to display uniquely in various cultures. You can define the number of decimal places with the SpinEditSettings.Properties.DecimalPlaces (SpinEditProperties.DecimalPlaces) property.
End-users can change the SpinEdit value via a mouse wheel and keyboard (the ARROW UP and ARROW DOWN keys - for small increments/decrements; the CTRL+ARROW UP and CTRL+ARROW DOWN, or PAGE UP and PAGE DOWN keys - for large increments/decrements).
When end-users press and hold a spin button, it results in the continuous incrementing/decrementing of the editor value. The auto-repeat functionality is also available when end-users press the UP and DOWN keys to increment or decrement a value.
Full-Featured Client-Side API
You can operate with the editor values using the following methods.