SpinEdit Class
Represents an editor with spin buttons used to adjust a numerical value.
Namespace: DevExpress.Xpf.Editors
Assembly: DevExpress.Xpf.Core.v20.1.dll
NuGet Packages: DevExpress.WindowsDesktop.Wpf.Core, DevExpress.Wpf.Core
Declaration
Remarks
The SpinEdit class represents a text editor with a pair of spin buttons that end-users can click to adjust a value. Spin buttons are used to increment or decrement the editor’s value displayed in the text edit region.
Tip
The SpinEdit class inherits its features from the ButtonEdit class.
Refer to the ButtonEdit class description for information on derived features and API.
Create a SpinEdit
The spin editor’s value is specified via the SpinEdit.Value property.
<Window ...
xmlns:dxe="http://schemas.devexpress.com/winfx/2008/xaml/editors">
<!-- Specify value using the TextEditBase.Text property -->
<dxe:SpinEdit Value="8" Increment="0.5" MinValue="0" MaxValue="10" AllowSpinOnMouseWheel="False" />
To respond to changing the editor’s value, handle the BaseEdit.EditValueChanged event. To check the new value’s validity, handle the BaseEdit.Validate event.
Value Edit Options
The editor’s increment value, by which the edit value is changed every time the editor is spun, is specified by the SpinEdit.Increment property.
The editor’s value can be integer or floating-point. Use the SpinEdit.IsFloatValue property to specify the editor’s value type.
Minimum and Maximum Values
The minimum and maximum allowed values are specified by the SpinEdit.MinValue and SpinEdit.MaxValue properties, respectively. Use the SpinEdit.Minimize or SpinEdit.Maximize method to set the editor’s value to the minimum or maximum value, respectively.
Useful API:
Mouse Wheel Input
End-users can modify the SpinEdit‘s value with a mouse wheel.
Setting the SpinEdit’s TextEdit.AllowSpinOnMouseWheel property to true activates the mouse wheel input processing.
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the SpinEdit class.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.