Share via


GestureSettings Enum

Definition

Specifies the interactions that are supported by an application.

This enumeration supports a bitwise combination of its member values.

public enum class GestureSettings
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
enum class GestureSettings
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public enum GestureSettings
var value = Microsoft.UI.Input.GestureSettings.none
Public Enum GestureSettings
Inheritance
GestureSettings
Attributes

Fields

Name Value Description
None 0

Disable support for gestures and manipulations.

Tap 1

Enable support for the tap gesture.

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

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 4

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 8

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 16

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 32

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 64

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 128

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 256

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 512

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 1024

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 2048

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 4096

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

ManipulationRotateInertia 8192

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

ManipulationScaleInertia 16384

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 32768

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 65536

Enable panning and disable zoom when two or more touch contacts are detected.Prevents unintentional zoom interactions when panning with multiple fingers.

Applies to