UseOptimizedManipulationRouting Property

FrameworkElement.UseOptimizedManipulationRouting Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets or sets a value that indicates whether the system should handle input events or whether the FrameworkElement should handle input events.

Namespace:  System.Windows
Assembly:  System.Windows (in System.Windows.dll)

Public Property UseOptimizedManipulationRouting As Boolean

Property Value

Type: System.Boolean
true if the system should handle input events; false if the FrameworkElement should handle input events. The default is true.

Dependency property identifier field: UseOptimizedManipulationRoutingProperty

In most cases, you should leave this property set to true. It is rare that you would need to use this property. You might need to set this property to false when you expect to receive a ManipulationDelta event for a particular element, but you don’t receive one.

The following is a hypothetical example that uses this property. Consider that you have a Panorama or Pivot control that includes a user control. Also, consider that the user control can handle horizontal gestures. If you want the user control to receive the horizontal gestures, you must set the UseOptimizedManipulationRouting property on the user control to false.

The following controls intercept manipulation events:

Windows Phone OS

Supported in: 8.1, 8.0

© 2017 Microsoft