ManipulationModes Enum

Definition

Namespace:

Windows.UI.Xaml.Input

Specifies how a target UI element interprets manipulation events. This enumeration is flagwise, so you can set multiple modes for the ManipulationMode property.

This enumeration supports a bitwise combination of its member values.

public enum class ManipulationModes

/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class ManipulationModes

[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum ManipulationModes

Public Enum ManipulationModes

Inheritance

Enum

ManipulationModes

Attributes

FlagsAttribute ContractVersionAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Fields

Name	Value	Description
None	0	Do not present graphic interaction with manipulation events.
TranslateX	1	Permit manipulation actions that translate the target on the X axis.
TranslateY	2	Permit manipulation actions that translate the target on the Y axis.
TranslateRailsX	4	Permit manipulation actions that translate the target on the X axis but using a rails mode.
TranslateRailsY	8	Permit manipulation actions that translate the target on the Y axis but using a rails mode.
Rotate	16	Permit manipulation actions that rotate the target.
Scale	32	Permit manipulation actions that scale the target.
TranslateInertia	64	Apply inertia to translate actions.
RotateInertia	128	Apply inertia to rotate actions.
ScaleInertia	256	Apply inertia to scale actions.
All	65535	Enable all manipulation interaction modes except those supported through Direct Manipulation
System	65536	Enable system-driven touch interactions supported through Direct Manipulation.

Remarks

Note

Direct Manipulation defines a manipulation as the scrolling or zooming of some part of the application UI.

This enumeration provides the value for the UIElement.ManipulationMode property. By setting this property you can enable app code handling for manipulation events such as ManipulationStarted. You must set the ManipulationMode to a value other than System or None to enable handling the events from that element. For more info on manipulations, see Handle pointer input.

Value enforcement for possible combinations is documented in the Remarks for the UIElement.ManipulationMode property.

See also

• ManipulationMode
• Handle pointer input