UIElement::ManipulationInertiaStarting Event

.NET Framework (current version)

Occurs when the input device loses contact with the UIElement object during a manipulation and inertia begins.

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

event EventHandler<ManipulationInertiaStartingEventArgs^>^ ManipulationInertiaStarting {
	void add(EventHandler<ManipulationInertiaStartingEventArgs^>^ value);
	void remove(EventHandler<ManipulationInertiaStartingEventArgs^>^ value);

The ManipulationInertiaStarting event occurs when the user lifts all of the fingers from the screen during a manipulation. For example, if a user "throws" a UIElement across a surface, the user will touch the UIElement to begin the action, move the finger across the screen for a short distance, and then release the UIElement. When the user releases the element, inertia begins and the ManipulationInertiaStarting event occurs. The UIElement continues to receive ManipulationDelta events to indicate that inertia is occurring on the element.

You can use this event to specify the behavior of the inertia. For example, you can set the initial velocity that is used when inertia begins. You can also specify the amount of inertia by setting the desired deceleration or by setting the desired placement. You can set these values for each type of manipulation (translation, expansion, or rotation) independently. For more information, see ManipulationInertiaStartingEventArgs.

For more information about manipulations, see the Input Overview. For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

The following example shows the ManipulationInertiaStarting event handler and sets the desired deceleration for translation, expansion, and rotation that is used during inertia. This example is part of a larger example in Walkthrough: Creating Your First Touch Application.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 4.0
Return to top