UIElement.ManipulationDelta UIElement.ManipulationDelta UIElement.ManipulationDelta UIElement.ManipulationDelta Event

Definition

Tritt ein, wenn sich die Position des Eingabegeräts während einer Bearbeitung ändert.Occurs when the input device changes position during a manipulation.

public:
 event EventHandler<System::Windows::Input::ManipulationDeltaEventArgs ^> ^ ManipulationDelta;
public event EventHandler<System.Windows.Input.ManipulationDeltaEventArgs> ManipulationDelta;
member this.ManipulationDelta : EventHandler<System.Windows.Input.ManipulationDeltaEventArgs> 
Public Custom Event ManipulationDelta As EventHandler(Of ManipulationDeltaEventArgs) 

Beispiele

Das folgende Beispiel zeigt einen Ereignishandler für die ManipulationDelta Ereignis.The following example shows an event handler for the ManipulationDelta event. Im Beispiel wird die DeltaManipulation Eigenschaft zu verschieben, drehen und Ändern der Größe einer Rectangle.The example uses the DeltaManipulation property to move, resize, and rotate a Rectangle. Im Beispiel wird auch überprüft, ob die ManipulationDelta Ereignis aufgetreten ist, während der Trägheit und gibt an, ob das Rechteck den Rand eines Fensters berührt.The example also checks whether the ManipulationDelta event occurred during inertia and whether the rectangle is touching the edge of a window. Wenn die Fälle zutreffen, reagiert die Anwendung die Bearbeitung, um zu verhindern, dass das Rechteck verlässt den sichtbaren Bereich der Anwendung.If those cases are true, the application stops the manipulation to prevent the rectangle from leaving the visible area of the application. In diesem Beispiel ist Teil eines umfangreicheren Beispiels unter Exemplarische Vorgehensweise: Erstellen der ersten Fingereingabeanwendung.This example is part of a larger example in Walkthrough: Creating Your First Touch Application.

void Window_ManipulationDelta(object sender, ManipulationDeltaEventArgs e)
{
    
    // Get the Rectangle and its RenderTransform matrix.
    Rectangle rectToMove = e.OriginalSource as Rectangle;
    Matrix rectsMatrix = ((MatrixTransform)rectToMove.RenderTransform).Matrix;

    // Rotate the Rectangle.
    rectsMatrix.RotateAt(e.DeltaManipulation.Rotation, 
                         e.ManipulationOrigin.X, 
                         e.ManipulationOrigin.Y);

    // Resize the Rectangle.  Keep it square 
    // so use only the X value of Scale.
    rectsMatrix.ScaleAt(e.DeltaManipulation.Scale.X, 
                        e.DeltaManipulation.Scale.X, 
                        e.ManipulationOrigin.X,
                        e.ManipulationOrigin.Y);

    // Move the Rectangle.
    rectsMatrix.Translate(e.DeltaManipulation.Translation.X,
                          e.DeltaManipulation.Translation.Y);

    // Apply the changes to the Rectangle.
    rectToMove.RenderTransform = new MatrixTransform(rectsMatrix);

    Rect containingRect =
        new Rect(((FrameworkElement)e.ManipulationContainer).RenderSize);

    Rect shapeBounds =
        rectToMove.RenderTransform.TransformBounds(
            new Rect(rectToMove.RenderSize));

    // Check if the rectangle is completely in the window.
    // If it is not and intertia is occuring, stop the manipulation.
    if (e.IsInertial && !containingRect.Contains(shapeBounds))
    {
        e.Complete();
    }

    
    e.Handled = true;
}
Private Sub Window_ManipulationDelta(ByVal sender As Object, ByVal e As ManipulationDeltaEventArgs)

    ' Get the Rectangle and its RenderTransform matrix.
    Dim rectToMove As Rectangle = e.OriginalSource
    Dim rectTransform As MatrixTransform = rectToMove.RenderTransform
    Dim rectsMatrix As Matrix = rectTransform.Matrix


    ' Rotate the shape
    rectsMatrix.RotateAt(e.DeltaManipulation.Rotation,
                         e.ManipulationOrigin.X,
                         e.ManipulationOrigin.Y)

    ' Resize the Rectangle. Keep it square 
    ' so use only the X value of Scale.
    rectsMatrix.ScaleAt(e.DeltaManipulation.Scale.X,
                        e.DeltaManipulation.Scale.X,
                        e.ManipulationOrigin.X,
                        e.ManipulationOrigin.Y)

    'move the center
    rectsMatrix.Translate(e.DeltaManipulation.Translation.X,
                          e.DeltaManipulation.Translation.Y)

    ' Apply the changes to the Rectangle.
    rectTransform = New MatrixTransform(rectsMatrix)
    rectToMove.RenderTransform = rectTransform

    Dim container As FrameworkElement = e.ManipulationContainer
    Dim containingRect As New Rect(container.RenderSize)

    Dim shapeBounds As Rect = rectTransform.TransformBounds(
                                New Rect(rectToMove.RenderSize))

    ' Check if the rectangle is completely in the window.
    ' If it is not and intertia is occuring, stop the manipulation.
    If e.IsInertial AndAlso Not containingRect.Contains(shapeBounds) Then
        e.Complete()
    End If

    e.Handled = True
End Sub

Hinweise

Die ManipulationDelta -Ereignis tritt mehrmals auf, wenn der Benutzer während eines Bearbeitungsvorgangs Finger über den Bildschirm zieht, und noch Mal, wenn Trägheit auftritt.The ManipulationDelta event occurs multiple times when the user drags fingers over the screen during a manipulation and again when inertia occurs. Sie können die IsInertial Eigenschaft zu überprüfen, ob das Ereignis während der Trägheit auftritt.You can use the IsInertial property to check whether the event is occurring during inertia.

Das Element mit ManipulationDelta Ereignis tritt auf, wird nicht in keiner Weise beeinflusst, wenn das Ereignis eintritt.The element on with ManipulationDelta event occurs is not affected in any way when the event occurs. Sie müssen die Logik für das Element angeben, die bearbeitet werden.You must provide the logic to the element that is to be manipulated. Die CumulativeManipulation und DeltaManipulation Eigenschaften, die vom Typ ManipulationDelta, enthalten Daten wie die Position der Bearbeitungen ändern und als verschieben, Ändern der Größe oder Drehen eines Objekts interpretiert.The CumulativeManipulation and DeltaManipulation properties, which are of type ManipulationDelta, contain data about how the position of the manipulations change and interpreted as moving, resizing, or rotating an object. Wenden Sie diese Informationen, auf das Element, das bearbeitet werden soll.You apply that information to the element that is to be manipulated.

Weitere Informationen zu Manipulationen, finden Sie unter den Übersicht über die Eingabe.For more information about manipulations, see the Input Overview. Ein Beispiel für eine Anwendung, die auf Manipulationen reagiert, finden Sie unter Exemplarische Vorgehensweise: Erstellen der ersten Fingereingabeanwendung.For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

Informationen zum RoutingereignisRouted Event Information

Feld "ID"Identifier field ManipulationDeltaEvent
Routing-StrategieRouting strategy BubblingBubbling
delegateDelegate Eine EventHandler<TEventArgs> vom Typ ManipulationDeltaEventArgs.EventHandler<TEventArgs> of type ManipulationDeltaEventArgs.

Gilt für: