Version

Configuring the Spin Acceleration

Topic Overview

Purpose

This topic introduces spin button acceleration for editor controls.

Spin Button Acceleration

Introduction

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;

Built-in spin button properties

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#:

ultraNumericEditor.SpinButtonIntervalSettings.AccelerationEnabled = true;

In Visual Basic:

ultraNumericEditor.SpinButtonIntervalSettings.AccelerationEnabled = True

SpinEditorButton

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

AutoRepeatEditorButton

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.

Supported Editor Controls

Summary

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.

Editor control Supports built-in spin buttons Supports spin button acceleration via…

WinCalculatorDropDown

No

WinCalendarCombo

Yes

Built-in spin button properties.

WinColorPicker

No

WinCombo

No

WinComboEditor

No

WinCurrencyEditor

Yes

Built-in spin button properties, and SpinEditorButton

WinDateTimeEditor

Yes

Built-in spin button properties, and SpinEditorButton

WinFontNameEditor

No

WinFormattedTextEditor

No

WinMaskedEdit

Yes

Built-in spin button properties, and SpinEditorButton

WinNumericEditor

Yes

Built-in spin button properties, and SpinEditorButton

WinTextEditor

No

WinTimeSpanEditor

No

WinTimeZoneEditor

No

Related Content

Topics

The following topic provides additional information related to this topic.

Topic Purpose

This topic applies to all WinEditor™ controls.