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 das ManipulationContainer auf das übergeordnete Element fest, das die Bearbeitungsereignisse empfängt, sodass die Koordinaten der Bearbeitung relativ zum übergeordneten Element sind. Dieses Beispiel ist Teil eines größeren Beispiels in Exemplarische Vorgehensweise: Erstellen Ihrer First Touch-Anwendung.

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 für ein Element auf, dessen Eigenschaft auf true festgelegt istIsManipulationEnabled, wenn der Benutzer einen Finger darauf legt. Standardmäßig melden nachfolgende Bearbeitungsereignisse die Position der Bearbeitung relativ zum Element, das auf truefestgelegt istIsManipulationEnabled. Sie können angeben, dass die Position relativ zu einem anderen Element sein soll, indem Sie die ManipulationContainer -Eigenschaft festlegen. Beispielsweise können Sie die Bearbeitung relativ zum übergeordneten Element vornehmen.

Sie können auch folgendes in einem Ereignishandler für ManipulationStartingausführen:

• Geben Sie an, ob der Benutzer mehr als einen Finger benötigt, um die Bearbeitungen auszuführen, indem Sie die ManipulationStartingEventArgs.IsSingleTouchEnabled -Eigenschaft festlegen.

• Geben Sie an, welche Bearbeitungstypen aktiviert sind, indem Sie die ManipulationStartingEventArgs.Mode -Eigenschaft auf eine ManipulationModes Enumeration festlegen.

• Geben Sie die Mitte einer Drehung mit einem Finger an, indem Sie die ManipulationStartingEventArgs.Pivot -Eigenschaft festlegen.

• Brechen Sie die Bearbeitung ab, indem Sie die ManipulationStartingEventArgs.Cancel -Methode aufrufen.

Weitere Informationen zu Bearbeitungen finden Sie in der Eingabeübersicht. Ein Beispiel für eine Anwendung, die auf Manipulationen reagiert, finden Sie unter Exemplarische Vorgehensweise: Erstellen Ihrer First Touch-Anwendung.

Informationen zum Routingereignis

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