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

Définition

Se produit lorsque le périphérique d'entrée change de position pendant une manipulation.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) 

Exemples

L’exemple suivant montre un gestionnaire d’événements pour le ManipulationDelta événement.The following example shows an event handler for the ManipulationDelta event. L’exemple utilise le DeltaManipulation propriété à déplacer, redimensionner et faire pivoter un Rectangle.The example uses the DeltaManipulation property to move, resize, and rotate a Rectangle. L’exemple vérifie également si le ManipulationDelta événement s’est produit pendant l’inertie et si le rectangle touche le bord d’une fenêtre.The example also checks whether the ManipulationDelta event occurred during inertia and whether the rectangle is touching the edge of a window. Si ces cas sont trues, l’application arrête la manipulation pour empêcher le rectangle de quitter la zone visible de l’application.If those cases are true, the application stops the manipulation to prevent the rectangle from leaving the visible area of the application. Cet exemple fait partie d’un exemple plus complet dans procédure pas à pas : Créer votre première Application 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

Remarques

Le ManipulationDelta événement produit plusieurs fois lorsque l’utilisateur fait glisser doigts sur l’écran pendant une manipulation et lorsque l’inertie se produit.The ManipulationDelta event occurs multiple times when the user drags fingers over the screen during a manipulation and again when inertia occurs. Vous pouvez utiliser le IsInertial propriété à vérifier si l’événement se produit pendant l’inertie.You can use the IsInertial property to check whether the event is occurring during inertia.

L’élément sur lequel ManipulationDelta événement se produit n’est pas affectée en aucune façon lorsque l’événement se produit.The element on with ManipulationDelta event occurs is not affected in any way when the event occurs. Vous devez fournir la logique à l’élément qui doit être manipulé.You must provide the logic to the element that is to be manipulated. Le CumulativeManipulation et DeltaManipulation propriétés, qui sont de type ManipulationDelta, contiennent des données sur la façon dont la position des manipulations change et interprété en tant que le déplacement, redimensionnement ou rotation d’un objet.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. Vous appliquez ces informations à l’élément qui doit être manipulé.You apply that information to the element that is to be manipulated.

Pour plus d’informations sur les manipulations, consultez le vue d’ensemble de l’entrée.For more information about manipulations, see the Input Overview. Pour obtenir un exemple d’une application qui répond à des manipulations, consultez procédure pas à pas : Créer votre première Application Touch.For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

Informations sur les événements acheminésRouted Event Information

Champ d’identificateurIdentifier field ManipulationDeltaEvent
Stratégie de routageRouting strategy PropagationBubbling
déléguéDelegate EventHandler<TEventArgs> de type ManipulationDeltaEventArgs.EventHandler<TEventArgs> of type ManipulationDeltaEventArgs.

S’applique à