UIElement.ManipulationDelta Evento

Definizione

Si verifica quando il dispositivo di input cambia posizione durante una manipolazione.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) 

Esempi

Nell'esempio seguente viene illustrato un gestore eventi per l'evento ManipulationDelta.The following example shows an event handler for the ManipulationDelta event. Nell'esempio viene utilizzata la proprietà DeltaManipulation per spostare, ridimensionare e ruotare una Rectangle.The example uses the DeltaManipulation property to move, resize, and rotate a Rectangle. Nell'esempio viene inoltre controllato se l'evento ManipulationDelta si è verificato durante l'inerzia e se il rettangolo tocca il bordo di una finestra.The example also checks whether the ManipulationDelta event occurred during inertia and whether the rectangle is touching the edge of a window. Se questi case sono true, l'applicazione interrompe la manipolazione per impedire che il rettangolo lasci l'area visibile dell'applicazione.If those cases are true, the application stops the manipulation to prevent the rectangle from leaving the visible area of the application. Questo esempio fa parte di un esempio più ampio in procedura dettagliata: creazione della prima applicazione touch.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

Commenti

L'evento ManipulationDelta si verifica più volte quando l'utente trascina le dita sullo schermo durante una manipolazione e di nuovo quando si verifica un'inerzia.The ManipulationDelta event occurs multiple times when the user drags fingers over the screen during a manipulation and again when inertia occurs. È possibile usare la proprietà IsInertial per verificare se l'evento si verifica durante l'inerzia.You can use the IsInertial property to check whether the event is occurring during inertia.

L'elemento in con ManipulationDelta evento si verifica non viene influenzato in alcun modo quando si verifica l'evento.The element on with ManipulationDelta event occurs is not affected in any way when the event occurs. È necessario specificare la logica per l'elemento che deve essere modificato.You must provide the logic to the element that is to be manipulated. Le proprietà CumulativeManipulation e DeltaManipulation, che sono di tipo ManipulationDelta, contengono dati sulla modifica della posizione delle modifiche e interpretate come lo stato di movimento, il ridimensionamento o la rotazione di un oggetto.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. Queste informazioni vengono applicate all'elemento che deve essere modificato.You apply that information to the element that is to be manipulated.

Per ulteriori informazioni sulle modifiche, vedere Cenni preliminari sull'input.For more information about manipulations, see the Input Overview. Per un esempio di applicazione che risponde alle modifiche, vedere procedura dettagliata: creazione della prima applicazione touch.For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

Informazioni evento indirizzatoRouted Event Information

Campo identificatoreIdentifier field ManipulationDeltaEvent
Strategia di routingRouting strategy BubblingBubbling
DelegatoDelegate EventHandler<TEventArgs> di tipo ManipulationDeltaEventArgs.EventHandler<TEventArgs> of type ManipulationDeltaEventArgs.

Si applica a