OnTouchDelta
Use the sub-routine OnTouchDelta in VBScript to perform an action each time the user manipulates the project screen or screen object.
Syntax
Sub OnTouchDelta(x,y,deltaX,deltaY,deltaScale,deltaExpansion,deltaRotation,cumulativeX,cumulativeY,cumulativeScale,cumulativeExpansion,cumulativeRotation,inertiaEnabled) … End Sub
- x
- The current x-coordinate (in pixels from the left of the screen) of the first touch point.
- y
- The current y-coordinate (in pixels from the top of the screen) of the first touch point.
- deltaX
- The change (in pixels) between the previous x-coordinate and the current x-coordinate of the first touch point.
- deltaY
- The change (in pixels) between the previous y-coordinate and the current y-coordinate of the first touch point.
- deltaScale
- The change (as a percentage) in the distance between the first and second touch points.
- deltaExpansion
- The change (in pixels) in the distance between the first and second touch points.
- deltaRotation
- The change in the angle of rotation (in radians) indicated by the first and second touch points.
- cumulativeX
- The total change (in pixels) between the starting x-coordinate and the current x-coordinate of the first touch point.
- cumulativeY
- The total change (in pixels) between the starting y-coordinate and the current y-coordinate of the first touch point.
- cumulativeScale
- The total change (as a percentage) in the distance between the first and second touch points, from the start of the manipulation.
- cumulativeExpansion
- The total change (in pixels) in the distance between the first and second touch points, from the start of the manipulation.
- cumulativeRotation
- The total change in the angle of rotation (in radians) indicated by the first and second touch points, from the start of the manipulation.
- inertiaEnabled
- A boolean value indicating whether inertia is enabled for the project screen or screen object.
Returned value
This is a sub-routine (as opposed to a function) in VBScript, so it does not return any value.
Notes
This sub-routine is based on the method ManipulationDelta in the Windows API. For more information, go to “Windows Touch Input” on the Microsoft Developer Network website at: msdn.microsoft.com/library/dd317321.aspx
The sub-routine is executed once for each discrete movement in the current manipulation. Changes in position require one touch point. Changes in size and/or rotation require two touch points.
You are not required to use the received parameters in your code. They simply make the raw touch input data available to you, for you to use (or not) as you deem necessary.