Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

UIElement.ManipulationStarting Event

Occurs when the manipulation processor is first created.

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
public event EventHandler<ManipulationStartingEventArgs> ManipulationStarting
<object ManipulationStarting="EventHandler<ManipulationStartingEventArgs>" .../>

The ManipulationStarting event occurs on an element that has the IsManipulationEnabled property set to true when the user puts a finger on it. By default, subsequent manipulation events report the position of the manipulation relative to the element that has IsManipulationEnabled set to true. You can specify that the position should be relative to another element by setting the ManipulationContainer property. For example, you can make the manipulation relative to the parent of the element.

You can also do the following in an event handler for ManipulationStarting:

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 event handler for the ManipulationStarting event and sets the ManipulationContainer to the parent element that receives the manipulation events so that the coordinates of the manipulation are relative to the parent element. This example is part of a larger example in Walkthrough: Creating Your First Touch Application.

void Window_ManipulationStarting(object sender, ManipulationStartingEventArgs e)
{
    e.ManipulationContainer = this;
    e.Handled = true;
}

.NET Framework

Supported in: 4.5.1, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.