Touch support discovery

Use the Multitouch class properties to set the scope of touch input your application handles. Then, test the environment to ensure that support exists for the events your Haxe code handles. Specifically, first establish the type of touch input for your application. The options are: touch point or none (interpret all touch input as mouse clicks and use mouse event handlers, only). Then, use the properties and methods of the Multitouch class to make sure that the runtime is in an environment that supports the touch input your application requires. Test the runtime environment for support of the types of touch input (such as whether it can interpret gestures), and respond accordingly.

Note: The Multitouch class properties are static properties, and do not belong to instances of any class. Use them with the syntax Multitouch.property, for example:

var touchSupport:Bool = Multitouch.supportsTouchEvents;

Set the input type

OpenFL must know the type of touch input to interpret, because a touch event can have many elements or phases. If a finger simply touches a touch-enabled screen, does the runtime dispatch a touch event? Or does it wait for a gesture? Or does the runtime track the touch as a mouse-down event? An application that supports touch input must establish the type of touch events it handles for OpenFL. Use the Multitouch.inputMode property to establish the type of touch input for the runtime. The input mode can be one of three options:

None

No special handling is provided for touch events. Set: Multitouch.inputMode = MultitouchInputMode.NONE and use the MouseEvent class to handle input.

Single touch points

All touch input is interpreted, individually, and all touch points can be tracked and handled. Set: Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT and use the TouchEvent class to handle input.

See Touch event handling for an example that uses the Multitouch.inputMode property to set the input type before handling a touch event.

Test for touch input support

Other properties of the Multitouch class provide values for fine-tuning your application to the current environment's touch support. OpenFL populates values for the number of simultaneous touch points allowed or gestures available. If the runtime is in an environment that does not support the touch event handling your application needs, provide the user with an alternative. For example, provide mouse event handling or information about what features are available, or not, in the current environment.

For more information about compatibility testing, see Troubleshooting.