ManipulationStartingEventArgs.Pivot Property

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets an object that describes the pivot for a single-point manipulation.

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

public ManipulationPivot Pivot { get; set; }

Property Value

Type: System.Windows.Input.ManipulationPivot

An object that describes the pivot for a single-point manipulation.

When you set the Pivot property, the manipulation will contain rotation data when the user uses one finger during a manipulation. This is to simulate real-world situations where you can use one finger to rotate an object, such as a piece of paper on a table. If the Pivot is null, the user must use two fingers to cause rotation.

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 an event handler for the ManipulationStarting event and sets the ManipulationStartingEventArgs.Pivot property. To test this example, follow the steps in Walkthrough: Creating Your First Touch Application and replace the code in step 4 with this code.

void Window_ManipulationStarting(object sender, ManipulationStartingEventArgs e)
    // Set the ManipulationPivot so that the element rotates as it is
    // moved with one finger.
    FrameworkElement element = e.OriginalSource as FrameworkElement;
    ManipulationPivot pivot = new ManipulationPivot();
    pivot.Center = new Point(element.ActualWidth / 2, element.ActualHeight / 2);
    pivot.Radius = 20;
    e.Pivot = pivot;

    e.ManipulationContainer = this;
    e.Handled = true;

.NET Framework
Available since 4.0
Return to top