NumericUpDown.Accelerations Property (System.Windows.Forms)

Accelerations Property

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

NumericUpDown..::.Accelerations Property

Gets a collection of sorted acceleration objects for the NumericUpDown control.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

Visual Basic (Declaration)

<BrowsableAttribute(False)> _
Public ReadOnly Property Accelerations As NumericUpDownAccelerationCollection

Visual Basic (Usage)

Dim instance As NumericUpDown
Dim value As NumericUpDownAccelerationCollection

value = instance.Accelerations

[BrowsableAttribute(false)]
public NumericUpDownAccelerationCollection Accelerations { get; }

Visual C++

[BrowsableAttribute(false)]
public:
property NumericUpDownAccelerationCollection^ Accelerations {
    NumericUpDownAccelerationCollection^ get ();
}

JScript

public function get Accelerations () : NumericUpDownAccelerationCollection

Property Value

Type: System.Windows.Forms..::.NumericUpDownAccelerationCollection
A NumericUpDownAccelerationCollection containing the sorted acceleration objects for the NumericUpDown control

Remarks

The Accelerations property can be used to increase the speed with which the NumericUpDown moves through a large set of numbers when the user holds the up or down arrow, either with the keyboard or with the mouse. Setting this property will decrease the number of ValueChanged events that occur depending on the Increment and Seconds property values specified for each NumericUpDownAcceleration object in the collection. The NumericUpDownAcceleration objects contained in the collection are sorted by their NumericUpDownAcceleration..::.Seconds property.

Examples

The following code example demonstrates how to use the Accelerations property. To run this example, paste the following code into a form and call the InitializeAcceleratedUpDown method from the form's constructor or Load event-handling method. While the code is running, press and hold the up or down arrow to see the acceleration occur.

Visual Basic

Private numericUpDown1 As NumericUpDown

Private Sub InitializeAcceleratedUpDown() 
    numericUpDown1 = New NumericUpDown()
    numericUpDown1.Location = New Point(40, 40)
    numericUpDown1.Maximum = 40000
    numericUpDown1.Minimum = - 40000

    ' Add some accelerations to the control.
    numericUpDown1.Accelerations.Add(New NumericUpDownAcceleration(2, 100))
    numericUpDown1.Accelerations.Add(New NumericUpDownAcceleration(5, 1000))
    numericUpDown1.Accelerations.Add(New NumericUpDownAcceleration(8, 5000))
    Controls.Add(numericUpDown1)

End Sub

private NumericUpDown numericUpDown1;
private void InitializeAcceleratedUpDown()
{
    numericUpDown1 = new NumericUpDown();
    numericUpDown1.Location = new Point(40, 40);
    numericUpDown1.Maximum = 40000;
    numericUpDown1.Minimum = -40000;

    // Add some accelerations to the control.
    numericUpDown1.Accelerations.Add(new NumericUpDownAcceleration(2,100));
    numericUpDown1.Accelerations.Add(new NumericUpDownAcceleration(5, 1000));
    numericUpDown1.Accelerations.Add(new NumericUpDownAcceleration(8, 5000));
    Controls.Add(numericUpDown1);

}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

NumericUpDown Class

NumericUpDown Members

System.Windows.Forms Namespace

NumericUpDownAcceleration