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

Определение

Происходит, когда устройство ввода меняет положение в процессе манипуляции.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) 

Примеры

В примере показан обработчик событий для ManipulationDelta событий.The following example shows an event handler for the ManipulationDelta event. В примере используется DeltaManipulation свойство, чтобы перемещать, масштабировать и поворачивать Rectangle.The example uses the DeltaManipulation property to move, resize, and rotate a Rectangle. В примере также проверяется ли ManipulationDelta произошло событие во время инерции и ли прямоугольник касается края окна.The example also checks whether the ManipulationDelta event occurred during inertia and whether the rectangle is touching the edge of a window. Если существуют случаи, приложение останавливает обработку, чтобы прямоугольник покинуть видимой части приложения.If those cases are true, the application stops the manipulation to prevent the rectangle from leaving the visible area of the 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

Комментарии

ManipulationDelta Событие возникает несколько раз, когда пользователь перетаскивает пальцами по экрану во время манипуляции и при инерции.The ManipulationDelta event occurs multiple times when the user drags fingers over the screen during a manipulation and again when inertia occurs. Можно использовать IsInertial свойство, чтобы проверить, происходит ли событие во время инерции.You can use the IsInertial property to check whether the event is occurring during inertia.

Элемент, для с ManipulationDelta событием не изменяется каким-либо образом при возникновении события.The element on with ManipulationDelta event occurs is not affected in any way when the event occurs. Необходимо предоставить логику для элемента, для обработки.You must provide the logic to the element that is to be manipulated. CumulativeManipulation И DeltaManipulation свойства, которые относятся к типу ManipulationDelta, содержат данные о том, как позиция манипуляции изменяется и интерпретируется как перемещение, изменение размера или повороте объекта.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. Эти сведения применяются к элементу, который должен обрабатываться.You apply that information to the element that is to be manipulated.

Дополнительные сведения о манипуляциях, см. в разделе Общие сведения о входных данных.For more information about manipulations, see the Input Overview. Пример приложения, которое реагирует на манипуляции, см. в разделе Пошаговое руководство: Создание первого приложения Touch.For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

Сведения о маршрутизируемом событииRouted Event Information

Поле идентификатораIdentifier field ManipulationDeltaEvent
Стратегия маршрутизацииRouting strategy Восходящая маршрутизацияBubbling
делегатDelegate EventHandler<TEventArgs> имеет тип данных ManipulationDeltaEventArgs.EventHandler<TEventArgs> of type ManipulationDeltaEventArgs.

Применяется к