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

Definición

Se produce cuando el dispositivo de entrada cambia de posición durante una manipulación.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) 

Ejemplos

El ejemplo siguiente muestra un controlador de eventos para el ManipulationDelta eventos.The following example shows an event handler for the ManipulationDelta event. El ejemplo se usa el DeltaManipulation propiedad para mover, girar y cambiar el tamaño de un Rectangle.The example uses the DeltaManipulation property to move, resize, and rotate a Rectangle. El ejemplo también se comprueba si el ManipulationDelta se ha producido un evento durante la inercia y si el rectángulo toca el borde de una ventana.The example also checks whether the ManipulationDelta event occurred during inertia and whether the rectangle is touching the edge of a window. Si se cumplen esos casos, la aplicación detiene la manipulación para evitar que el rectángulo salir del área visible de la aplicación.If those cases are true, the application stops the manipulation to prevent the rectangle from leaving the visible area of the application. Este ejemplo forma parte de un ejemplo más extenso en Tutorial: Crear su primera aplicación táctil.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

Comentarios

El ManipulationDelta evento tiene lugar varias veces cuando el usuario arrastra dedos a través de la pantalla durante una manipulación y nuevo cuando se produce la inercia.The ManipulationDelta event occurs multiple times when the user drags fingers over the screen during a manipulation and again when inertia occurs. Puede usar el IsInertial propiedad para comprobar si el evento tiene lugar durante la inercia.You can use the IsInertial property to check whether the event is occurring during inertia.

El elemento con el ManipulationDelta evento tiene lugar no se ve afectado de ninguna manera cuando se produce el evento.The element on with ManipulationDelta event occurs is not affected in any way when the event occurs. Debe proporcionar la lógica para el elemento que se pueden manipular.You must provide the logic to the element that is to be manipulated. El CumulativeManipulation y DeltaManipulation propiedades, que son del tipo ManipulationDelta, contienen datos acerca de cómo cambiar la posición de las manipulaciones e interpreta como mover, cambiar el tamaño o girar un objeto.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. Aplicar esa información para el elemento que se pueden manipular.You apply that information to the element that is to be manipulated.

Para obtener más información acerca de las manipulaciones, vea el Input Overview.For more information about manipulations, see the Input Overview. Para obtener un ejemplo de una aplicación que responde a manipulaciones, vea Tutorial: Crear su primera aplicación táctil.For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

Información sobre eventos enrutadosRouted Event Information

Campo de identificadorIdentifier field ManipulationDeltaEvent
Estrategia de enrutamientoRouting strategy PropagaciónBubbling
delegadoDelegate EventHandler<TEventArgs> de tipo ManipulationDeltaEventArgs.EventHandler<TEventArgs> of type ManipulationDeltaEventArgs.

Se aplica a