OnTouchCompleted

Use the sub-routine OnTouchCompleted in VBScript to perform an action when the user stops touching the project screen or screen object.

Syntax

Sub OnTouchCompleted(x,y,cumulativeX,cumulativeY,cumulativeScale,cumulativeExpansion,cumulativeRotation)

…

End Sub

x

The ending x-coordinate (in pixels from the left of the screen) of the first touch point.

y

The ending y-coordinate (in pixels from the top of the screen) of the first touch point.

cumulativeX

The total change (in pixels) between the starting x-coordinate and the ending x-coordinate of the first touch point.

cumulativeY

The total change (in pixels) between the starting y-coordinate and the ending 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 to the end of the manipulation.

cumulativeExpansion

The total change (in pixels) in the distance between the first and second touch points, from the start to the end 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 to the end of the manipulation.

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 ManipulationCompleted 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 when the manipulation is completed — that is, when the last touch point is removed from the project screen or screen object.

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.