UIElement.ManipulationDelta Zdarzenie

Definicja

Występuje, gdy urządzenie wejściowe zmienia pozycję podczas manipulowania.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) 

Typ zdarzenia

EventHandler<ManipulationDeltaEventArgs>

Przykłady

Poniższy przykład pokazuje procedurę obsługi zdarzeń dla ManipulationDelta zdarzenia.The following example shows an event handler for the ManipulationDelta event. W przykładzie użyta jest DeltaManipulation Właściwość do przenoszenia, zmiany rozmiaru i obrotu Rectangle .The example uses the DeltaManipulation property to move, resize, and rotate a Rectangle. Przykład sprawdza także, czy ManipulationDelta zdarzenie wystąpiło w czasie bezwładności i czy prostokąt dotyka krawędzi okna.The example also checks whether the ManipulationDelta event occurred during inertia and whether the rectangle is touching the edge of a window. Jeśli te przypadki mają wartość true, aplikacja przestanie działać, aby zapobiec wychodzeniu przez prostokąt widocznego obszaru aplikacji.If those cases are true, the application stops the manipulation to prevent the rectangle from leaving the visible area of the application. Ten przykład jest częścią większego przykładu w instruktażu: Tworzenie pierwszej aplikacji dotykowej.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

Uwagi

ManipulationDeltaZdarzenie występuje kilka razy, gdy użytkownik przeciągnie palców na ekranie podczas manipulowania i ponownie, gdy nastąpi bezwładności.The ManipulationDelta event occurs multiple times when the user drags fingers over the screen during a manipulation and again when inertia occurs. Możesz użyć właściwości, IsInertial Aby sprawdzić, czy zdarzenie występuje podczas bezwładności.You can use the IsInertial property to check whether the event is occurring during inertia.

W przypadku wystąpienia zdarzenia nie ma to wpływu na element ManipulationDelta występujący w zdarzeniu.The element on with ManipulationDelta event occurs is not affected in any way when the event occurs. Musisz podać logikę do elementu, który ma być manipulowany.You must provide the logic to the element that is to be manipulated. CumulativeManipulationWłaściwości i DeltaManipulation , które są typu ManipulationDelta , zawierają dane dotyczące sposobu zmieniania i interpretowania pozycji manipulacji jako przesuwania, zmiany rozmiarów lub obracania obiektu.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. Te informacje są stosowane do elementu, który ma być manipulowany.You apply that information to the element that is to be manipulated.

Aby uzyskać więcej informacji na temat manipulowania, zobacz przegląd danych wejściowych.For more information about manipulations, see the Input Overview. Przykład aplikacji reagującej na manipulowanie, zobacz Przewodnik: Tworzenie pierwszej aplikacji dotykowej.For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

Informacje dotyczące kierowanego zdarzeniaRouted Event Information

Pole identyfikatoraIdentifier field ManipulationDeltaEvent
Strategia routinguRouting strategy PropagacjaBubbling
DelegatDelegate EventHandler<TEventArgs> typu ManipulationDeltaEventArgs.EventHandler<TEventArgs> of type ManipulationDeltaEventArgs.

Dotyczy