UIElement.ManipulationStarting Ereignis

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Tritt bei der ersten Erstellung des Manipulationsprozessors auf.

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) 

Ereignistyp

EventHandler<ManipulationStartingEventArgs>

Beispiele

Das folgende Beispiel zeigt den Ereignishandler für das ManipulationStarting Ereignis und legt den ManipulationContainer übergeordneten Element fest, der die Manipulationsereignisse empfängt, sodass die Koordinaten der Manipulation relativ zum übergeordneten Element sind. Dieses Beispiel ist Teil eines größeren Beispiels 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

Hinweise

Das ManipulationStarting Ereignis tritt auf einem Element auf, auf das die IsManipulationEnabled Eigenschaft festgelegt true ist, wenn der Benutzer einen Finger darauf legt. Standardmäßig melden nachfolgende Manipulationsereignisse die Position der Manipulation relativ zum Element, auf das festgelegt ist IsManipulationEnabled true. Sie können angeben, dass die Position relativ zu einem anderen Element sein soll, indem Sie die ManipulationContainer Eigenschaft festlegen. Sie können beispielsweise die Manipulation relativ zum übergeordneten Element vornehmen.

Sie können auch Folgendes in einem Ereignishandler ManipulationStartingfür :

• Geben Sie an, ob der Benutzer mehrere Finger benötigt, um die Manipulationen auszuführen, indem Sie die ManipulationStartingEventArgs.IsSingleTouchEnabled Eigenschaft festlegen.

• Geben Sie an, welche Arten von Manipulationen aktiviert sind, indem Sie die ManipulationStartingEventArgs.Mode Eigenschaft auf eine ManipulationModes Enumeration festlegen.

• Geben Sie die Mitte einer Einzelfingerdrehung an, indem Sie die ManipulationStartingEventArgs.Pivot Eigenschaft festlegen.

• Abbrechen der Manipulation durch Aufrufen der ManipulationStartingEventArgs.Cancel Methode.

Weitere Informationen zu Manipulationen finden Sie in der Eingabeübersicht. Ein Beispiel für eine Anwendung, die auf Manipulationen reagiert, finden Sie unter Walkthrough: Creating Your First Touch Application.

Informationen zum Routingereignis

Bezeichnerfeld	ManipulationStartingEvent
Routingstrategie	Bubbling
Delegat	Eine EventHandler<TEventArgs> vom Typ ManipulationStartingEventArgs.