Add a Touch Event to a screen object

Add a Touch Event to a screen object in order to process touch input on that object.

This task is a supplement to other topics that discuss how to use multi-touch gestures in your project. You must have the Multi-Touch feature enabled, either for your entire project or for a specific project screen, and you must have either Inner or Outer mode selected. For more information, see About the Multi-Touch settings for project screens.

Also, this task assumes you have already created the screen object to which you want to add the Touch Event, and it begins from that point.

Touch Events are added to a screen object through the Command animation.

To add a Touch Event to a screen object:

1. Click the screen object to which you want to add the Touch Event.

   The screen object is selected.

2. On the Draw tab of the ribbon, in the Animations group, click Command.

   The Command animation is added to the selected screen object.

3. Double-click the screen object.

   The Object Properties dialog is displayed.

4. If the Command animation properties are not already displayed, then in the properties list (in the top-right corner of the dialog), click Command.

5. If the VBScript event tabs are not already displayed, then in the Type list, click VBScript.

   

6. In the VBScript event tabs, click the tab for the Touch Event that you want to add.

   You might need to use the arrow buttons to scroll left and right through the tabs.

   Tab	Description
   On Touch	Process the raw data from the touch input. The sub-routine is continuously executed while the user touches the screen object.
   On Touch Start	Perform an action once, when the user starts touching the screen object.
   On Touch Delta	Perform an action each time the user moves their fingers on the screen object.
   On Touch Completed	Perform an action once, when the user stops touching the screen object.

7. Click in the text box below, and then type your VBScript code.

At this point, you can develop the Touch Event just as you would develop any other VBScript sub-routine in your project. For more information, see Overview of VBScript.

The OnTouch sub-routines each have predefined parameters that are described in subsequent topics in this section. Do not edit those parameters; they receive data from the touch input and then make it available for use in your code.