SET-ACCELERATION Action

This document covers the following topics:


Description

Defines or clears the acceleration for a spin control. The acceleration is the change in spin rate over time, when either one of the spin control arrow buttons is held down, or when one of the up or down arrow keys is held down whilst the spin control has the focus.

Spin controls have a default acceleration, which can be either removed or changed via this action.

Parameters

Name/Data Type Explanation
HANDLE OF SPINCTRL Input

Handle of spin control for which the acceleration is to be set.

Delay (I4) Input (repeating parameter)

Delay (in seconds) before the associated increment is set. The Delay and Increment parameters are specified in pairs. The first delay value specified must be zero. Subsequent delay values must be specified in ascending order.

Increment (I4) Input (repeating parameter)

Increment size to apply after associated delay time has elapsed.

Response (I4) Output

Natural error (if applicable).

Example:

 
/* Set increment to 1 initially, to 3 after 5 seconds, and
/* to 10 after 15 seconds:
PROCESS GUI ACTION SET-ACCELERATION WITH #SPIN-1
  0 1 5 3 15 10 GIVING *ERROR
*
/* Remove any existing acceleration (increment always 1):
PROCESS GUI ACTION SET-ACCELERATION WITH #SPIN-1
  0 1 GIVING *ERROR