ManipulationProcessor2D Class

ManipulationProcessor2D Class

.NET Framework (current version)
 

Implements a multiple-input, single-output compositor for two-dimensional (2-D) transformations in a shared coordinate space.

Namespace:   System.Windows.Input.Manipulations
Assembly:  System.Windows.Input.Manipulations (in System.Windows.Input.Manipulations.dll)

System.Object
  System.Windows.Input.Manipulations.ManipulationProcessor2D

public class ManipulationProcessor2D

NameDescription
System_CAPS_pubmethodManipulationProcessor2D(Manipulations2D)

Creates a new ManipulationProcessor2D object.

System_CAPS_pubmethodManipulationProcessor2D(Manipulations2D, ManipulationPivot2D)

Creates a new ManipulationProcessor2D object.

NameDescription
System_CAPS_pubpropertyMinimumScaleRotateRadius

Gets or sets the minimum radius, in coordinate units, necessary for a manipulator to participate in scaling and rotation.

System_CAPS_pubpropertyPivot

Gets or sets the pivot information for the manipulation processor.

System_CAPS_pubpropertySupportedManipulations

Gets or sets the current set of supported manipulations.

NameDescription
System_CAPS_pubmethodCompleteManipulation(Int64)

Forces the current manipulation to complete and raises the Completed event.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodProcessManipulators(Int64, IEnumerable<Manipulator2D>)

Processes the specified manipulators as a single batch action.

System_CAPS_pubmethodSetParameters(ManipulationParameters2D)

Sets parameters on the manipulation processor.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubeventCompleted

Occurs when a manipulation has competed.

System_CAPS_pubeventDelta

Occurs when the manipulation origin has changed or when translation, scaling, or rotation have occurred.

System_CAPS_pubeventStarted

Occurs when a new manipulation has started.

A ManipulationProcessor2D object treats a collection of manipulators as a composite object. Your application is then freed from the necessity of tracking and managing individual manipulators.

A manipulation processor by itself does not cause an element to move. Your application begins a manipulation as necessary, and then receives information from a manipulation processor by listening to the Started, Delta and Completed events. The values received via these events enable you to change the location, size or orientation of an element as needed.

You inform a manipulation processor which types of manipulations are allowed (translate, scale, rotate) by setting the SupportedManipulations property. You can then provide non-conditional logic to the transformation of the element that is being manipulated. For instance, instead of checking if rotation is enabled before changing the orientation of an element, you can unconditionally apply the rotation factor received from the manipulation processor; if rotation is not enabled, the manipulation processor will report that no rotational change has occurred.

When an element that is being manipulated is released (all manipulators are removed), you can use inertia processing to simulate friction and cause the element to gradually slow its movements before coming to a stop. For more information see the InertiaProcessor2D class.

.NET Framework
Available since 4.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft