Documentation

Class TouchManager

A utility class that exposes methods that enable touch management.

Inheritance
System.Object
TouchManager
Namespace: Telerik.Windows.Input.Touch
Assembly: Telerik.Windows.Controls.dll

Syntax

public static class TouchManager : Object

Fields

DragStartTriggerProperty

Identifies the DragStartTrigger dependency property.

Declaration
public static readonly DependencyProperty DragStartTriggerProperty
Field Value
System.Windows.DependencyProperty

ScrollViewerSwipeModeProperty

Identifies the ScrollViewerSwipeMode dependency property.

Declaration
public static readonly DependencyProperty ScrollViewerSwipeModeProperty
Field Value
System.Windows.DependencyProperty

ShouldSuspendMousePromotionProperty

Identifies the ShouldSuspendMousePromotion dependency property.

Declaration
public static readonly DependencyProperty ShouldSuspendMousePromotionProperty
Field Value
System.Windows.DependencyProperty

TouchModeProperty

Identifies the TouchMode dependency property.

Declaration
public static readonly DependencyProperty TouchModeProperty
Field Value
System.Windows.DependencyProperty

Properties

DragStartDistance

Gets or sets the minimum distance a touch point has to move before the action is considered a drag.

Declaration
public static double DragStartDistance { get; set; }
Property Value
System.Double

IsEnabled

Gets or sets a value indicating whether the TouchManager hooks to any input events. Should be set at the start of the application. Once set to false it cannot be set back to true.

Declaration
public static bool IsEnabled { get; set; }
Property Value
System.Boolean

IsTouchEnabled

Gets or sets a value indicating whether the TouchManager responds to any touch events.

Declaration
public static bool IsTouchEnabled { get; set; }
Property Value
System.Boolean

MultiTapTime

Gets or sets the time, in milliseconds, that can elapse between two successive tap actions for the TouchManager to consider them multiple-taps.

Declaration
public static int MultiTapTime { get; set; }
Property Value
System.Int32

MultiTapVicinity

Gets or sets the maximum distance between two successive tap actions for the TouchManager to consider them multiple-taps.

Declaration
public static double MultiTapVicinity { get; set; }
Property Value
System.Double

PinchStartDistance

Gets or sets the minimum distance a touch point has to move before the action is considered a pinch.

Declaration
public static double PinchStartDistance { get; set; }
Property Value
System.Double

SwipeInertiaDuration

Gets or sets the duration of the swipe inertia, in milliseconds.

Declaration
public static int SwipeInertiaDuration { get; set; }
Property Value
System.Int32

SwipeStartDistance

Gets or sets the minimum distance a touch point has to move before the action is considered a swipe.

Declaration
public static double SwipeStartDistance { get; set; }
Property Value
System.Double

TapTime

Gets or sets the time, in milliseconds, that can elapse between a touch down and a touch up for the action to be considered a tap.

Declaration
public static int TapTime { get; set; }
Property Value
System.Int32

TapVicinity

Gets or sets the maximum distance a touch point can move for the action to be considered a tap.

Declaration
public static double TapVicinity { get; set; }
Property Value
System.Double

Methods

AddDragEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the Drag event.

Declaration
public static void AddDragEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddDragFinishedEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the DragFinished event.

Declaration
public static void AddDragFinishedEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddDragStartedEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the DragStarted event. If this event is not handled, the Drag operation will finish.

Declaration
public static void AddDragStartedEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddLostTouchCaptureHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the LostTouchCapture event.

Declaration
public static void AddLostTouchCaptureHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddPinchEventHandler(UIElement, PinchEventHandler, Boolean)

Adds a handler for the Pinch event.

Declaration
public static void AddPinchEventHandler(UIElement element, PinchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

PinchEventHandler handler

System.Boolean handledEventsToo

AddPinchFinishedEventHandler(UIElement, PinchEventHandler, Boolean)

Adds a handler for the PinchFinished event.

Declaration
public static void AddPinchFinishedEventHandler(UIElement element, PinchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

PinchEventHandler handler

System.Boolean handledEventsToo

AddPinchStartedEventHandler(UIElement, PinchEventHandler, Boolean)

Adds a handler for the PinchStarted event.

Declaration
public static void AddPinchStartedEventHandler(UIElement element, PinchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

PinchEventHandler handler

System.Boolean handledEventsToo

AddSwipeEventHandler(UIElement, SwipeEventHandler, Boolean)

Adds a handler for the Swipe event.

Declaration
public static void AddSwipeEventHandler(UIElement element, SwipeEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

SwipeEventHandler handler

System.Boolean handledEventsToo

AddSwipeFinishedEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the SwipeFinished event.

Declaration
public static void AddSwipeFinishedEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddSwipeInertiaEventHandler(UIElement, SwipeInertiaEventHandler, Boolean)

Adds a handler for the SwipeInertia event.

Declaration
public static void AddSwipeInertiaEventHandler(UIElement element, SwipeInertiaEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

SwipeInertiaEventHandler handler

System.Boolean handledEventsToo

AddSwipeInertiaFinishedEventHandler(UIElement, RadRoutedEventHandler, Boolean)

Adds a handler for the SwipeInertiaFinished event.

Declaration
public static void AddSwipeInertiaFinishedEventHandler(UIElement element, RadRoutedEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

RadRoutedEventHandler handler

System.Boolean handledEventsToo

AddSwipeInertiaStartedEventHandler(UIElement, RadRoutedEventHandler, Boolean)

Adds a handler for the SwipeInertiaStarted event.

Declaration
public static void AddSwipeInertiaStartedEventHandler(UIElement element, RadRoutedEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

RadRoutedEventHandler handler

System.Boolean handledEventsToo

AddSwipeStartedEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the SwipeStarted event.

Declaration
public static void AddSwipeStartedEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddTapAndHoldEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the TapAndHold event.

Declaration
public static void AddTapAndHoldEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddTapEventHandler(UIElement, TapEventHandler, Boolean)

Adds a handler for the Tap event.

Declaration
public static void AddTapEventHandler(UIElement element, TapEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TapEventHandler handler

System.Boolean handledEventsToo

AddTapHoldAndReleaseEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the TapHoldAndRelease event.

Declaration
public static void AddTapHoldAndReleaseEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddTouchDownEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the TouchDown event.

Declaration
public static void AddTouchDownEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddTouchEnterEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the TouchEnter event.

Declaration
public static void AddTouchEnterEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddTouchLeaveEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the TouchLeave event.

Declaration
public static void AddTouchLeaveEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddTouchMoveEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the TouchMove event.

Declaration
public static void AddTouchMoveEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

AddTouchUpEventHandler(UIElement, TouchEventHandler, Boolean)

Adds a handler for the TouchUp event.

Declaration
public static void AddTouchUpEventHandler(UIElement element, TouchEventHandler handler, bool handledEventsToo = false)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

System.Boolean handledEventsToo

CaptureTouch(UIElement, TouchDevice)

Attempts to capture the touch device.

Declaration
public static bool CaptureTouch(UIElement element, TouchDevice touchDevice)
Parameters
System.Windows.UIElement element

System.Windows.Input.TouchDevice touchDevice

Returns
System.Boolean

CeaseGestures(FrameworkElement)

Ceases the execution of any active gestures for elements within this root element. When root is null, all active gestures cease.

Declaration
public static void CeaseGestures(FrameworkElement root)
Parameters
System.Windows.FrameworkElement root

GetCaptured(TouchDevice)

Gets the element that has captured the touch device.

Declaration
public static UIElement GetCaptured(TouchDevice touchDevice)
Parameters
System.Windows.Input.TouchDevice touchDevice

Returns
System.Windows.UIElement

GetDragStartTrigger(DependencyObject)

Gets a value indicating which action starts a drag operation.

Declaration
public static TouchDragStartTrigger GetDragStartTrigger(DependencyObject obj)
Parameters
System.Windows.DependencyObject obj

Returns
TouchDragStartTrigger

GetScrollViewerSwipeMode(DependencyObject)

Gets the scroll viewer swipe mode.

Declaration
public static ScrollViewerSwipeMode GetScrollViewerSwipeMode(DependencyObject obj)
Parameters
System.Windows.DependencyObject obj

Returns
ScrollViewerSwipeMode

GetShouldSuspendMousePromotion(DependencyObject)

Gets a value indicating whether mouse events should be suspended during touch input.

Declaration
public static bool GetShouldSuspendMousePromotion(DependencyObject obj)
Parameters
System.Windows.DependencyObject obj

Returns
System.Boolean

GetTouchMode(DependencyObject)

Gets a value indicating the touch mode of the object.

Declaration
public static TouchMode GetTouchMode(DependencyObject obj)
Parameters
System.Windows.DependencyObject obj

Returns
TouchMode

ReleaseTouchCapture(UIElement, TouchDevice)

Releases the touch capture.

Declaration
public static bool ReleaseTouchCapture(UIElement element, TouchDevice touchDevice)
Parameters
System.Windows.UIElement element

System.Windows.Input.TouchDevice touchDevice

Returns
System.Boolean

RemoveDragEventHandler(UIElement, TouchEventHandler)

Removes the handler for the Drag event.

Declaration
public static void RemoveDragEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveDragFinishedEventHandler(UIElement, TouchEventHandler)

Removes the handler for the DragFinished event.

Declaration
public static void RemoveDragFinishedEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveDragStartedEventHandler(UIElement, TouchEventHandler)

Removes the handler for the DragStarted event.

Declaration
public static void RemoveDragStartedEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveLostTouchCaptureHandler(UIElement, TouchEventHandler)

Removes the handler for the LostTouchCapture event.

Declaration
public static void RemoveLostTouchCaptureHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemovePinchEventHandler(UIElement, PinchEventHandler)

Removes the handler for the Pinch event.

Declaration
public static void RemovePinchEventHandler(UIElement element, PinchEventHandler handler)
Parameters
System.Windows.UIElement element

PinchEventHandler handler

RemovePinchFinishedEventHandler(UIElement, PinchEventHandler)

Removes the handler for the PinchFinished event.

Declaration
public static void RemovePinchFinishedEventHandler(UIElement element, PinchEventHandler handler)
Parameters
System.Windows.UIElement element

PinchEventHandler handler

RemovePinchStartedEventHandler(UIElement, PinchEventHandler)

Removes the handler for the PinchStarted event.

Declaration
public static void RemovePinchStartedEventHandler(UIElement element, PinchEventHandler handler)
Parameters
System.Windows.UIElement element

PinchEventHandler handler

RemoveSwipeEventHandler(UIElement, SwipeEventHandler)

Removes the handler for the Swipe event.

Declaration
public static void RemoveSwipeEventHandler(UIElement element, SwipeEventHandler handler)
Parameters
System.Windows.UIElement element

SwipeEventHandler handler

RemoveSwipeFinishedEventHandler(UIElement, TouchEventHandler)

Removes the handler for the SwipeFinished event.

Declaration
public static void RemoveSwipeFinishedEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveSwipeInertiaEventHandler(UIElement, SwipeInertiaEventHandler)

Removes the handler for the SwipeInertia event.

Declaration
public static void RemoveSwipeInertiaEventHandler(UIElement element, SwipeInertiaEventHandler handler)
Parameters
System.Windows.UIElement element

SwipeInertiaEventHandler handler

RemoveSwipeInertiaFinishedEventHandler(UIElement, RadRoutedEventHandler)

Removes the handler for the SwipeInertiaFinished event.

Declaration
public static void RemoveSwipeInertiaFinishedEventHandler(UIElement element, RadRoutedEventHandler handler)
Parameters
System.Windows.UIElement element

RadRoutedEventHandler handler

RemoveSwipeInertiaStartedEventHandler(UIElement, RadRoutedEventHandler)

Removes the handler for the SwipeInertiaStarted event.

Declaration
public static void RemoveSwipeInertiaStartedEventHandler(UIElement element, RadRoutedEventHandler handler)
Parameters
System.Windows.UIElement element

RadRoutedEventHandler handler

RemoveSwipeStartedEventHandler(UIElement, TouchEventHandler)

Removes the handler for the SwipeStarted event.

Declaration
public static void RemoveSwipeStartedEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveTapAndHoldEventHandler(UIElement, TouchEventHandler)

Removes the handler for the TapAndHold event.

Declaration
public static void RemoveTapAndHoldEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveTapEventHandler(UIElement, TapEventHandler)

Removes the handler for the Tap event.

Declaration
public static void RemoveTapEventHandler(UIElement element, TapEventHandler handler)
Parameters
System.Windows.UIElement element

TapEventHandler handler

RemoveTapHoldAndReleaseEventHandler(UIElement, TouchEventHandler)

Removes the handler for the TapHoldAndRelease event.

Declaration
public static void RemoveTapHoldAndReleaseEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveTouchDownEventHandler(UIElement, TouchEventHandler)

Removes the handler for the TouchDown event.

Declaration
public static void RemoveTouchDownEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveTouchEnterEventHandler(UIElement, TouchEventHandler)

Removes the handler for the TouchEnter event.

Declaration
public static void RemoveTouchEnterEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveTouchLeaveEventHandler(UIElement, TouchEventHandler)

Removes the handler for the TouchLeave event.

Declaration
public static void RemoveTouchLeaveEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveTouchMoveEventHandler(UIElement, TouchEventHandler)

Removes the handler for the TouchMove event.

Declaration
public static void RemoveTouchMoveEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

RemoveTouchUpEventHandler(UIElement, TouchEventHandler)

Removes the handler for the TouchUp event.

Declaration
public static void RemoveTouchUpEventHandler(UIElement element, TouchEventHandler handler)
Parameters
System.Windows.UIElement element

TouchEventHandler handler

SetDragStartTrigger(DependencyObject, TouchDragStartTrigger)

Sets a value indicating which action starts a drag operation.

Declaration
public static void SetDragStartTrigger(DependencyObject obj, TouchDragStartTrigger value)
Parameters
System.Windows.DependencyObject obj

TouchDragStartTrigger value

SetScrollViewerSwipeMode(DependencyObject, ScrollViewerSwipeMode)

Sets the scroll viewer swipe mode.

Declaration
public static void SetScrollViewerSwipeMode(DependencyObject obj, ScrollViewerSwipeMode value)
Parameters
System.Windows.DependencyObject obj

ScrollViewerSwipeMode value

SetShouldSuspendMousePromotion(DependencyObject, Boolean)

Sets a value indicating whether mouse events should be suspended during touch input.

Declaration
public static void SetShouldSuspendMousePromotion(DependencyObject obj, bool value)
Parameters
System.Windows.DependencyObject obj

System.Boolean value

SetTouchMode(DependencyObject, TouchMode)

Sets a value indicating the touch mode of the object.

Declaration
public static void SetTouchMode(DependencyObject obj, TouchMode value)
Parameters
System.Windows.DependencyObject obj

TouchMode value