UIElement.ManipulationStarting Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when the manipulation processor is first created.
public:
event EventHandler<System::Windows::Input::ManipulationStartingEventArgs ^> ^ ManipulationStarting;
public event EventHandler<System.Windows.Input.ManipulationStartingEventArgs> ManipulationStarting;
member this.ManipulationStarting : EventHandler<System.Windows.Input.ManipulationStartingEventArgs>
Public Custom Event ManipulationStarting As EventHandler(Of ManipulationStartingEventArgs)
Event Type
Examples
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;
}
Private Sub Window_ManipulationStarting(ByVal sender As Object, ByVal e As ManipulationStartingEventArgs)
e.ManipulationContainer = Me
e.Handled = True
End Sub
Remarks
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:
Specify whether the user needs more than one finger to perform the manipulations by setting the ManipulationStartingEventArgs.IsSingleTouchEnabled property.
Specify which types of manipulation are enabled by setting the ManipulationStartingEventArgs.Mode property to a ManipulationModes enumeration.
Specify the center of a single-finger rotation by setting the ManipulationStartingEventArgs.Pivot property.
Cancel the manipulation by calling the ManipulationStartingEventArgs.Cancel method.
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.
Routed Event Information
Identifier field | ManipulationStartingEvent |
Routing strategy | Bubbling |
Delegate | EventHandler<TEventArgs> of type ManipulationStartingEventArgs. |