Description

When a user clicks the up or down button of an up-down control and holds it for a period of time, the control’s value changes at a higher speed. In other words, the control can use acceleration to change the rate of increasing or decreasing its value. Acceleration information includes time interval settings and the number of units to increase or decrease the control’s value. An up-down control can use several degrees of acceleration or none at all. The wAcceleration property provides access to an acceleration item by its index. The total number of acceleration items is specified by the wAccelerationCount property.

Declaration

TestObj.wAcceleration(Index)

Read-Only Property Win32AccelerationInfo object

TestObj	A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Index	[in]	Required	Integer

Applies To

The property is applied to the following object:

Win32 UpDown Control

View Mode

To view this property in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.

Parameters

The property has the following parameter:

Index

Specifies the index of the desired acceleration item. The first item has index 0, the second - 1, and so on.

Property Value

A Win32AccelerationInfo object that contains the acceleration parameters.

Remarks

If the specified acceleration item is not found, the wAcceleration property returns an empty value (Nothing in VBScript, null in JavaScript, JScript, C++Script and C#Script, None in Python and nil in DelphiScript) and posts an error message to the test log.

Example

To view an example that demonstrates how to use the wAcceleration property, see UpDown Acceleration Information in Desktop Windows Applications.

wAcceleration Property (UpDown Controls)