Version

Touch Gestures Events

Topic Overview

Purpose

This topic introduces the Infragistics touch-enabled controls’ gestures events.

In this topic

This topic contains the following sections:

Introduction

Touch Gestures Events Introduction

New touch gestures handling capabilities are now available to the UltraControlBase class providing you with the ability to allow or prevent their functionalities. The events listed below encapsulate gestures such as panning , zooming , rotating , press-and-tap , press-and-hold and two-finger-tap .

Touch Gestures Events

The following section details the touch gesture events in response to user interactions provided they are not cancelled.

Events Description

Raised when the user initially makes contact with the touch surface. It is the first of the gesture-related events raised upon user interaction.

Leaving the event argument’s Mode property set to All; its default value; enables all gestures and raises their corresponding events.

Raised when the system gesture recognizer identifies the user interaction as a gesture supported by the operating system. It always follows the GestureQueryStatus event.

Setting the event argument’s Cancel property to True prevents any other events from being raised from this gesture.

Raised initially immediately following the GestureStarting event and continuously thereafter as the contact point changes location and immediately after losing contact. The gesture’s speed determines if the visible content continues to scroll following contact. This behavior is known as inertia or inertial panning.

Setting the event argument’s Handled property to True prevents the default actions scrolling, selecting and dragging depending on the direction of the initial movement, from occurring.

Raised initially immediately following the GestureStarting event and continuously thereafter as the contact point changes location and immediately after losing contact for example, as the user’s fingers move closer together or further apart.

There is no default action for ZoomGesture event.

Raised initially immediately following the GestureStarting event and continuously thereafter as the users second finger; non-stationary; continues to move for example, as the user’s finger moves around the pivot point.

There is no default action for the RotateGesture event.

Raised only once, immediately following the GestureStarting event.

Setting the event argument’s Handled property to True prevents the default actions scrolling, selecting and dragging depending on the direction of the initial movement, from occurring.

Raised only once, immediately following the GestureStarting event.

There is no default action for TwoFingerTapGesture event.

Raised twice

  • Initially, the first raised event coincides with the elapsing of the press-and-hold timeout, for example, when the amount of time specified by the PressAndHold property has elapsed.

  • Additionally, raised a second time when the user loses contact with the touch surface.

Setting the event argument’s Handled property to True prevents the default actions scrolling, selecting and dragging depending on the direction of the initial movement, from occurring.

Raised once for each gesture, after the raising of the last gesture-specific event.

Related Content

Topics

The following topics provide additional information related to this topic.

Topic Purpose

The topics in this group illustrate Infragistics touch-enabled control’s Touch Gestures.

This topic explains the Infragistics touch-enabled controls’ touch gesture functionality and usage.