GestureSettings enumeration

Applies to Windows and Windows Phone

Specifies the interactions that are supported by an application.

Syntax


public enum GestureSettings

Attributes

[Flags()]
[Version(0x06020000)]

Members

The GestureSettings enumeration has these members.

MemberValueDescription
None | none0

Disable support for gestures and manipulations.

Tap | tap1

Enable support for the tap gesture.

  • Touch: tap
  • Mouse: left button click
  • Pen/stylus: tap
DoubleTap | doubleTap2

Enable support for the double-tap gesture.

  • Touch: double tap
  • Mouse: left button double click
  • Pen/stylus: double tap

This gesture can be used to select a word or open a file or folder.

Hold | hold4

Enable support for the press and hold gesture (from a single touch or pen/stylus contact). The Holding event is raised if a time threshold is crossed before the contact is lifted, an additional contact is detected, or a gesture is started.

  • Touch: press and hold
  • Pen/stylus: press and hold

This gesture can be used to display a context menu.

HoldWithMouse | holdWithMouse8

Enable support for the press and hold gesture through the left button on a mouse. The Holding event is raised if a time threshold is crossed before the left button is released or a gesture is started.

This gesture can be used to display a context menu.

RightTap | rightTap16

Enable support for a right-tap interaction. The RightTapped event is raised when the contact is lifted or the mouse button released.

  • Touch: press and hold
  • Mouse: press and hold, right button click
  • Pen/stylus: press and hold, tap with barrel button pressed

This gesture can be used to display a context menu.

Drag | drag32

Enable support for the slide or swipe gesture with a mouse or pen/stylus (single contact). The Dragging event is raised when either gesture is detected.

This gesture can be used for text selection, selecting or rearranging objects, or scrolling and panning.

Note  Mouse and pen/stylus input does not raise manipulation events (ManipulationStarted, ManipulationUpdated, and ManipulationCompleted) during the course of this interaction.

Specifying support for Drag and one or more of the manipulation settings enables a single device to perform multiple actions. For example, the slide or swipe gesture can be performed with the left mouse button to select text while the wheel button can be rolled to scroll content.

ManipulationTranslateX | manipulationTranslateX64

Enable support for the slide gesture through pointer input, on the horizontal axis. The ManipulationStarted, ManipulationUpdated, and ManipulationCompleted events are all raised during the course of this interaction.

This gesture can be used for rearranging objects.

ManipulationTranslateY | manipulationTranslateY128

Enable support for the slide gesture through pointer input, on the vertical axis. The ManipulationStarted, ManipulationUpdated, and ManipulationCompleted events are all raised during the course of this interaction.

This gesture can be used for rearranging objects.

ManipulationTranslateRailsX | manipulationTranslateRailsX256

Enable support for the slide gesture through pointer input, on the horizontal axis using rails (guides). The ManipulationStarted, ManipulationUpdated, and ManipulationCompleted events are all raised during the course of this interaction.

This gesture can be used for rearranging objects.

ManipulationTranslateRailsY | manipulationTranslateRailsY512

Enable support for the slide gesture through pointer input, on the vertical axis using rails (guides). The ManipulationStarted, ManipulationUpdated, and ManipulationCompleted events are all raised during the course of this interaction.

This gesture can be used for rearranging objects.

ManipulationRotate | manipulationRotate1024

Enable support for the rotation gesture through pointer input. The ManipulationStarted, ManipulationUpdated, and ManipulationCompleted events are all raised during the course of this interaction.

ManipulationScale | manipulationScale2048

Enable support for the pinch or stretch gesture through pointer input.

These gestures can be used for optical or semantic zoom and resizing an object. The ManipulationStarted, ManipulationUpdated, and ManipulationCompleted events are all raised during the course of this interaction.

ManipulationTranslateInertia | manipulationTranslateInertia4096

Enable support for translation inertia after the slide gesture (through pointer input) is complete. The ManipulationInertiaStarting event is raised if inertia is enabled.

ManipulationRotateInertia | manipulationRotateInertia8192

Enable support for rotation inertia after the rotate gesture (through pointer input) is complete. The ManipulationInertiaStarting event is raised if inertia is enabled.

ManipulationScaleInertia | manipulationScaleInertia16384

Enable support for scaling inertia after the pinch or stretch gesture (through pointer input) is complete. The ManipulationInertiaStarting event is raised if inertia is enabled.

CrossSlide | crossSlide32768

Enable support for the CrossSliding interaction when using the slide or swipe gesture through a single touch contact.

This gesture can be used for selecting or rearranging objects.

ManipulationMultipleFingerPanning | manipulationMultipleFingerPanning65536

Enable panning and disable zoom when two or more touch contacts are detected.

Prevents unintentional zoom interactions when panning with multiple fingers.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.UI.Input
Windows::UI::Input [C++]

Metadata

Windows.winmd

 

 

Show:
© 2014 Microsoft