ManipulationDeltaEventArgs Classe

Définition

Espace de noms:

System.Windows.Input

Assembly:

PresentationCore.dll

Fournit des données pour l'événement ManipulationDelta.

public ref class ManipulationDeltaEventArgs sealed : System::Windows::Input::InputEventArgs

public sealed class ManipulationDeltaEventArgs : System.Windows.Input.InputEventArgs

type ManipulationDeltaEventArgs = class
    inherit InputEventArgs

Public NotInheritable Class ManipulationDeltaEventArgs
Inherits InputEventArgs

Héritage

Object

EventArgs

RoutedEventArgs

InputEventArgs

ManipulationDeltaEventArgs

Exemples

L’exemple suivant montre un gestionnaire d’événements pour l’événement ManipulationDelta . L’exemple utilise la DeltaManipulation propriété pour déplacer, redimensionner et faire pivoter un Rectangle. L’exemple vérifie également si l’événement ManipulationDelta s’est produit pendant l’inertie et si le rectangle touche le bord d’une fenêtre. Si ces cas sont vrais, l’application arrête la manipulation pour empêcher le rectangle de quitter la zone visible de l’application. Cet exemple fait partie d’un exemple plus large dans Procédure pas à pas : création de votre application first touch.

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

La ManipulationDeltaEventArgs classe contient des données sur les modifications apportées à la position d’une manipulation. La DeltaManipulation propriété contient les modifications qui se sont produites depuis le dernier ManipulationDelta événement. La CumulativeManipulation propriété contient le nombre total de modifications qui se sont produites pour la manipulation en cours. Vous utilisez l’une de ces propriétés pour transformer l’objet manipulé.

Vous pouvez mettre fin à une manipulation en appelant la Complete méthode ou forcer la manipulation à l’inertie en appelant la StartInertia méthode.

Propriétés

CumulativeManipulation	Obtient les modifications cumulées de la manipulation actuelle.
DeltaManipulation	Obtient les modifications les plus récentes de la manipulation actuelle.
Device	Obtient le périphérique d'entrée qui a initialisé cet événement. (Hérité de InputEventArgs)
Handled	Obtient ou définit une valeur qui indique l’état actuel de la gestion des événements pour un événement routé le long de son itinéraire. (Hérité de RoutedEventArgs)
IsInertial	Obtient une valeur qui indique si l'événement ManipulationDelta se produit pendant l'inertie.
ManipulationContainer	Obtient le conteneur qui définit les coordonnées pour la manipulation.
ManipulationOrigin	Obtient le point d'origine de la manipulation.
Manipulators	Obtient une collection d'objets qui représente les contacts tactiles de la manipulation.
OriginalSource	Obtient la source de signalement d’origine telle que déterminée par un test de positionnement pur, avant tout ajustement Source pouvant être effectué par une classe parente. (Hérité de RoutedEventArgs)
RoutedEvent	Obtient ou définit le RoutedEvent associé à cette instance de RoutedEventArgs. (Hérité de RoutedEventArgs)
Source	Obtient ou définit une référence à l’objet ayant déclenché l’événement. (Hérité de RoutedEventArgs)
Timestamp	Obtient l'heure à laquelle cet événement s'est produit. (Hérité de InputEventArgs)
Velocities	Obtient les taux des modifications les plus récentes pour la manipulation.

Méthodes

Cancel()	Annule la manipulation.
Complete()	Effectue la manipulation sans inertie.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InvokeEventHandler(Delegate, Object)	Appelle des gestionnaires d'événements selon une méthode spécifique à un type, ce qui peut améliorer l'efficacité du système d'événements. (Hérité de InputEventArgs)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnSetSource(Object)	En cas de substitution dans une classe dérivée, fournit un point d'entrée de notification de rappel dès que la valeur de propriété Source d'une instance change. (Hérité de RoutedEventArgs)
ReportBoundaryFeedback(ManipulationDelta)	Spécifie que la manipulation a dépassé certaines limites.
StartInertia()	Démarre l'inertie sur la manipulation en ignorant les déplacements de contact suivants et en déclenchant l'événement ManipulationInertiaStarting.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)