ManipulationCompletedRoutedEventArgs
ManipulationCompletedRoutedEventArgs
ManipulationCompletedRoutedEventArgs
ManipulationCompletedRoutedEventArgs
Class
Definition
Provides data for the ManipulationCompleted event.
public : sealed class ManipulationCompletedRoutedEventArgs : RoutedEventArgs, IManipulationCompletedRoutedEventArgspublic sealed class ManipulationCompletedRoutedEventArgs : RoutedEventArgs, IManipulationCompletedRoutedEventArgsPublic NotInheritable Class ManipulationCompletedRoutedEventArgs Inherits RoutedEventArgs Implements IManipulationCompletedRoutedEventArgs// This API is not available in Javascript.
- Inheritance
-
ManipulationCompletedRoutedEventArgsManipulationCompletedRoutedEventArgsManipulationCompletedRoutedEventArgsManipulationCompletedRoutedEventArgs
- Attributes
| Device family |
Windows 10 (introduced v10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced v1)
|
Inherited Members
Inherited properties
Examples
The following code example shows scenario 4 from the Input sample. This code shows some usage patterns for direct manipulation using the ManipulationStarting, ManipulationStarted, ManipulationDelta, ManipulationInertiaStarting, and ManipulationCompleted events.
private TransformGroup _transformGroup;
private MatrixTransform _previousTransform;
private CompositeTransform _compositeTransform;
private bool forceManipulationsToEnd;
public Scenario4()
{
this.InitializeComponent();
forceManipulationsToEnd = false;
ManipulateMe.ManipulationStarting +=
new ManipulationStartingEventHandler(
ManipulateMe_ManipulationStarting);
ManipulateMe.ManipulationStarted +=
new ManipulationStartedEventHandler(
ManipulateMe_ManipulationStarted);
ManipulateMe.ManipulationDelta +=
new ManipulationDeltaEventHandler(
ManipulateMe_ManipulationDelta);
ManipulateMe.ManipulationCompleted +=
new ManipulationCompletedEventHandler(
ManipulateMe_ManipulationCompleted);
ManipulateMe.ManipulationInertiaStarting +=
new ManipulationInertiaStartingEventHandler(
ManipulateMe_ManipulationInertiaStarting);
InitManipulationTransforms();
}
private void InitManipulationTransforms()
{
_transformGroup = new TransformGroup();
_compositeTransform = new CompositeTransform();
_previousTransform = new MatrixTransform() {
Matrix = Matrix.Identity };
_transformGroup.Children.Add(_previousTransform);
_transformGroup.Children.Add(_compositeTransform);
ManipulateMe.RenderTransform = _transformGroup;
}
private void ManipulateMe_ManipulationStarting(object sender,
ManipulationStartingRoutedEventArgs e)
{
forceManipulationsToEnd = false;
e.Handled = true;
}
private void ManipulateMe_ManipulationStarted(
object sender, ManipulationStartedRoutedEventArgs e)
{
e.Handled = true;
}
private void ManipulateMe_ManipulationInertiaStarting(
object sender, ManipulationInertiaStartingRoutedEventArgs e)
{
e.Handled = true;
}
private void ManipulateMe_ManipulationDelta(
object sender, ManipulationDeltaRoutedEventArgs e)
{
if (forceManipulationsToEnd)
{
e.Complete();
return;
}
_previousTransform.Matrix = _transformGroup.Value;
Point center = _previousTransform.TransformPoint(
new Point(e.Position.X, e.Position.Y));
_compositeTransform.CenterX = center.X;
_compositeTransform.CenterY = center.Y;
_compositeTransform.Rotation = (e.Delta.Rotation * 180) / Math.PI;
_compositeTransform.ScaleX =
_compositeTransform.ScaleY = e.Delta.Scale;
_compositeTransform.TranslateX = e.Delta.Translation.X;
_compositeTransform.TranslateY = e.Delta.Translation.Y;
e.Handled = true;
}
private void ManipulateMe_ManipulationCompleted(object sender,
ManipulationCompletedRoutedEventArgs e)
{
e.Handled = true;
}
private void Scenario4Reset(object sender, RoutedEventArgs e)
{
Scenario4Reset();
}
void Scenario4Reset()
{
forceManipulationsToEnd = true;
ManipulateMe.RenderTransform = null;
InitManipulationTransforms();
}
Private _transformGroup As TransformGroup
Private _previousTransform As MatrixTransform
Private _compositeTransform As CompositeTransform
Private forceManipulationsToEnd As Boolean
Public Sub New()
Me.InitializeComponent()
forceManipulationsToEnd = False
AddHandler ManipulateMe.ManipulationStarting, AddressOf ManipulateMe_ManipulationStarting
AddHandler ManipulateMe.ManipulationStarted, AddressOf ManipulateMe_ManipulationStarted
AddHandler ManipulateMe.ManipulationDelta, AddressOf ManipulateMe_ManipulationDelta
AddHandler ManipulateMe.ManipulationCompleted, AddressOf ManipulateMe_ManipulationCompleted
InitManipulationTransforms()
End Sub
''' <summary>
''' Invoked when this page is about to be displayed in a Frame.
''' </summary>
''' <param name="e">Event data that describes how this page was reached. The Parameter
''' property is typically used to configure the page.</param>
Protected Overrides Sub OnNavigatedTo(e As NavigationEventArgs)
End Sub
Private Sub InitManipulationTransforms()
_transformGroup = New TransformGroup()
_compositeTransform = New CompositeTransform()
_previousTransform = New MatrixTransform() With { _
.Matrix = Matrix.Identity _
}
_transformGroup.Children.Add(_previousTransform)
_transformGroup.Children.Add(_compositeTransform)
ManipulateMe.RenderTransform = _transformGroup
End Sub
Private Sub ManipulateMe_ManipulationStarting(sender As Object, e As ManipulationStartingRoutedEventArgs)
forceManipulationsToEnd = False
e.Handled = True
End Sub
Private Sub ManipulateMe_ManipulationStarted(sender As Object, e As ManipulationStartedRoutedEventArgs)
e.Handled = True
End Sub
Private Sub ManipulateMe_ManipulationDelta(sender As Object, e As ManipulationDeltaRoutedEventArgs)
If forceManipulationsToEnd Then
e.Complete()
Exit Sub
End If
_previousTransform.Matrix = _transformGroup.Value
Dim center As Point = _previousTransform.TransformPoint(New Point(e.Position.X, e.Position.Y))
_compositeTransform.CenterX = center.X
_compositeTransform.CenterY = center.Y
_compositeTransform.Rotation = (e.Delta.Rotation * 180) / Math.PI
_compositeTransform.ScaleX = InlineAssignHelper(_compositeTransform.ScaleY, e.Delta.Scale)
_compositeTransform.TranslateX = e.Delta.Translation.X
_compositeTransform.TranslateY = e.Delta.Translation.Y
e.Handled = True
End Sub
Private Sub ManipulateMe_ManipulationCompleted(sender As Object, e As ManipulationCompletedRoutedEventArgs)
e.Handled = True
End Sub
Private Sub Scenario4ResetMethod(sender As Object, e As RoutedEventArgs)
Reset()
End Sub
Private Sub Reset()
forceManipulationsToEnd = True
ManipulateMe.RenderTransform = Nothing
InitManipulationTransforms()
End Sub
Private Shared Function InlineAssignHelper(Of T)(ByRef target As T, value As T) As T
target = value
Return value
End Function
Constructors
ManipulationCompletedRoutedEventArgs() ManipulationCompletedRoutedEventArgs() ManipulationCompletedRoutedEventArgs() ManipulationCompletedRoutedEventArgs()
Initializes a new instance of the ManipulationCompletedRoutedEventArgs class.
public : ManipulationCompletedRoutedEventArgs()public ManipulationCompletedRoutedEventArgs()Public Sub New()// This API is not available in Javascript.
Properties
Container Container Container Container
Gets the UIElement that is considered the container of the manipulation.
public : UIElement Container { get; }public UIElement Container { get; }Public ReadOnly Property Container As UIElement// This API is not available in Javascript.
Cumulative Cumulative Cumulative Cumulative
Gets the overall changes since the beginning of the manipulation.
public : ManipulationDelta Cumulative { get; }public ManipulationDelta Cumulative { get; }Public ReadOnly Property Cumulative As ManipulationDelta// This API is not available in Javascript.
The overall changes since the beginning of the manipulation.
Handled Handled Handled Handled
Gets or sets a value that marks the routed event as handled. Setting to true prevents most handlers along the event route from handling the same event again.
public : PlatForm::Boolean Handled { get; set; }public bool Handled { get; set; }Public ReadWrite Property Handled As bool// This API is not available in Javascript.
- Value
- PlatForm::Boolean bool bool bool
true to mark the routed event handled; false to leave the routed event unhandled, which permits the event to potentially route further. The default is false.
- See Also
IsInertial IsInertial IsInertial IsInertial
Gets whether the ManipulationCompleted event occurs during inertia.
public : PlatForm::Boolean IsInertial { get; }public bool IsInertial { get; }Public ReadOnly Property IsInertial As bool// This API is not available in Javascript.
- Value
- PlatForm::Boolean bool bool bool
true if the ManipulationCompleted event occurs during inertia; false if the event occurs while the user's input device has contact with the element.
PointerDeviceType PointerDeviceType PointerDeviceType PointerDeviceType
Gets the PointerDeviceType for the pointer device involved in the manipulation.
public : PointerDeviceType PointerDeviceType { get; }public PointerDeviceType PointerDeviceType { get; }Public ReadOnly Property PointerDeviceType As PointerDeviceType// This API is not available in Javascript.
A value of the enumeration.
Position Position Position Position
Gets the x- and y- screen coordinates of the touch input at completed position.
public : Point Position { get; }public Point Position { get; }Public ReadOnly Property Position As Point// This API is not available in Javascript.
The x- and y- screen coordinates of the touch input at completed position.
- See Also
Velocities Velocities Velocities Velocities
Gets the velocities that are used for the manipulation.
public : ManipulationVelocities Velocities { get; }public ManipulationVelocities Velocities { get; }Public ReadOnly Property Velocities As ManipulationVelocities// This API is not available in Javascript.
The velocities that are used for the manipulation.