Configuring the Spin Acceleration

This topic introduces spin button acceleration for editor controls.

This topic contains the following sections:

Spin button provides capability to increase or decrease the speed at which values display in the editor. The spin button acceleration allows speeding up the spinning of the editor’s numerical or date/time value when pressing and holding the spin button. After about 5 repetitions the spinning starts occurring much faster.

Implemented in the Infragistics editor controls, this mechanism allows for spin button acceleration. Editor controls expose a threshold property on the spin button indicating the number of spins required to start the acceleration.

For example, threshold of 10 start accelerating after 10 spinning repetitions. The default threshold is 5 spin repetitions.

ultraNumericEditor.SpinButtonIntervalSettings.AccelerationThreshold = 10;

Editor controls that already have integral spin buttons expose a new feature called SpinButtonIntervalSettings containing the following 5 properties:

In order to enable spin button acceleration the AccelerationEnabled property must be set, for example, to True

In C#:

In Visual Basic:

As a stand-alone button element, the SpinEditorButton button now exposes five additional properties, similar to built-in spin buttons, supporting spin button acceleration.

The AutoRepeatEditorButton button is also a stand-alone button element providing similar functionality as the spin button. AutoRepeatEditorButton already exposes the Interval and InitialDelay properties requiring the addition of the following three properties to support spin button acceleration.

Some of the editor controls have a built-in spin buttons. Consequently, enabling spin button acceleration only requires one property setting. For other editor controls that do not have built-in spin buttons require that you configure either the ButtonLeft or ButtonRight buttons. This requires adding the SpinEditorButton, containing all the necessary properties for enabling spin button acceleration, to either the ButtonLeft or ButtonRight collection.

The following table lists all editor controls supporting spin button acceleration feature.

The following topic provides additional information related to this topic.