'Declaration Public Event PanGesture As PanGestureHandler
public event PanGestureHandler PanGesture
The event handler receives an argument of type PanGestureEventArgs containing data related to this event. The following PanGestureEventArgs properties provide information specific to this event.
| Property | Description |
|---|---|
| Gesture | Returns a constant identifying the gesture which triggered this event. |
| Handled (Inherited from Infragistics.Win.Touch.GestureEventArgs) | Returns or sets a boolean value indicating whether the event has been handled. |
| HorizontalInertia | Returns a vector which describes the horizontal inertia for this event. |
| IsInertial | Returns a boolean value indicating whether this event was triggered by inertia. |
| Location | Returns the location of the contact point at the time this event was fired. |
| VerticalInertia | Returns a vector which describes the vertical inertia for this event. |
Panning occurs when the user makes contact with the touch surface and drags the contact point. The location of the contact point is provided through the event arguments.
The PanGesture event continues to fire after the user loses contact with the touch surface; this is typically referred to as 'inertial' panning. The number of times the event continues to fire, as well as the magnitude of inertia, is dependent on the speed at which the contact point was moving when contact with the touch surface was lost.
Typically, controls respond to vertical panning deltas by scrolling, and to horizontal panning deltas by selecting items. Because a pan gesture can include both a vertical and a horizontal delta, and also because sometimes it is desirable to scroll in response to horizontal panning notifications rather than select items, a threshold delta is used to differentiate between the two different kinds of panning operations.
As in Windows Explorer, the direction of the initial phase of the panning operation determines which default action, if any, is performed by the control. When the location of the contact point moves a certain distance from the original point of contact, the control first determines which delta, vertical or horizontal, is larger.
If the vertical delta is larger, a scrolling operation is initiated. Once the scrolling operation is underway, horizontal deltas will also cause scrolling (assuming the control supports horizontal scrolling).
If the horizontal delta is larger, an item selection operation is initiated (assuming the control supports item selection). The user sees a 'lasso' selection rectangle similar to the one seen in Windows Explorer which, as it changes size, selects the items whose bounds intersect with the rectangle.
Note that some controls may reverse this behavior as appropriate; for example, if a control supports only horizontal scrolling, it may enter item selection mode when the vertical delta is exceeded, and scroll only when the horizontal delta is exceeded.
Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2