SpatialGestureSettings Enum

Definition

Namespace:

Windows.UI.Input.Spatial

This enumeration represents the set of gestures that may be recognized by a SpatialGestureRecognizer.

This enumeration supports a bitwise combination of its member values.

public enum class SpatialGestureSettings

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

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

var value = Windows.UI.Input.Spatial.SpatialGestureSettings.none

Public Enum SpatialGestureSettings

Inheritance

Enum

SpatialGestureSettings

Attributes

FlagsAttribute ContractVersionAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduced in v2.0)

Fields

Name	Value	Description
None	0	Disable support for gestures.
Tap	1	Enable support for the tap gesture. This represents either an air tap with a hand (finger press followed by finger release), saying the word "Select" with your voice, or pressing and releasing the Select trigger or button on a controller. This gesture can be used to activate the hologram or other object that the user is looking at. Handle the Tapped event to react to this gesture.
DoubleTap	2	Enable support for the double-tap gesture. This represents two quick air taps with a hand (finger press followed by finger release) or two quick presses and releases of the Select trigger or button on a controller. Handle the Tapped event and check that TapCount is 2 to react to this gesture.
Hold	4	Enable support for the hold gesture. This represents the user holding down either their finger or the Select trigger or button on a motion controller for longer than the system's hold threshold. This gesture can be used to take a secondary action, such as showing a menu. Handle the HoldStarted, HoldCompleted and/or HoldCanceled events to react to this gesture.
ManipulationTranslate	8	Enable support for the manipulation gesture, tracking changes to the hand's position. This represents the user holding down their finger and moving their hand around in the world. This gesture can be used to move, resize or rotate a hologram when you want the hologram to react 1:1 to the user's hand movements. This can also be used to draw new holograms in the world. Handle the ManipulationStarted, ManipulationUpdated, ManipulationCompleted and/or ManipulationCanceled events to react to this gesture.
NavigationX	16	Enable support for the navigation gesture, in the horizontal axis. This represents the user holding down their finger and moving their hand or a motion controller within a normalized cube with coordinates from -1.0 to 1.0. These are normalized values and do not represent any physical unit, such as meters. This gesture can be used to navigate UI widgets, such as radial menus. This can also be used to build velocity-based continuous scrolling or zooming gestures, similar to scrolling a 2D UI by clicking the middle mouse button and then moving the mouse up and down. Handle the NavigationStarted, NavigationUpdated, NavigationCompleted and/or NavigationCanceled events to react to this gesture.
NavigationY	32	Enable support for the navigation gesture, in the vertical axis. This represents the user holding down their finger and moving their hand or a motion controller within a normalized cube with coordinates from -1.0 to 1.0. These are normalized values and do not represent any physical unit, such as meters. This gesture can be used to navigate UI widgets, such as radial menus. This can also be used to build velocity-based continuous scrolling or zooming gestures, similar to scrolling a 2D UI by clicking the middle mouse button and then moving the mouse up and down. Handle the NavigationStarted, NavigationUpdated, NavigationCompleted and/or NavigationCanceled events to react to this gesture.
NavigationZ	64	Enable support for the navigation gesture, in the depth axis. This represents the user holding down their finger and moving their hand or a motion controller within a normalized cube with coordinates from -1.0 to 1.0. These are normalized values and do not represent any physical unit, such as meters. This gesture can be used to navigate UI widgets, such as radial menus. This can also be used to build velocity-based continuous scrolling or zooming gestures, similar to scrolling a 2D UI by clicking the middle mouse button and then moving the mouse up and down. Handle the NavigationStarted, NavigationUpdated, NavigationCompleted and/or NavigationCanceled events to react to this gesture.
NavigationRailsX	128	Enable support for the navigation gesture, in the horizontal axis using rails (guides). This represents the user holding down their finger and moving their hand or a motion controller within a normalized cube with coordinates from -1.0 to 1.0. These are normalized values and do not represent any physical unit, such as meters. This gesture can be used to build velocity-based scrolling or zooming that locks to an axis if the user initiates the gesture primarily in that direction. Handle the NavigationStarted, NavigationUpdated, NavigationCompleted and/or NavigationCanceled events to react to this gesture.
NavigationRailsY	256	Enable support for the navigation gesture, in the vertical axis using rails (guides). This represents the user holding down their finger and moving their hand or a motion controller within a normalized cube with coordinates from -1.0 to 1.0. These are normalized values and do not represent any physical unit, such as meters. This gesture can be used to build velocity-based scrolling or zooming that locks to an axis if the user initiates the gesture primarily in that direction. Handle the NavigationStarted, NavigationUpdated, NavigationCompleted and/or NavigationCanceled events to react to this gesture.
NavigationRailsZ	512	Enable support for the navigation gesture, in the depth axis using rails (guides). This represents the user holding down their finger and moving their hand or a motion controller within a normalized cube with coordinates from -1.0 to 1.0. These are normalized values and do not represent any physical unit, such as meters. This gesture can be used to build velocity-based scrolling or zooming that locks to an axis if the user initiates the gesture primarily in that direction. Handle the NavigationStarted, NavigationUpdated, NavigationCompleted and/or NavigationCanceled events to react to this gesture.

Remarks

SpatialGestureRecognizer performs only the minimal disambiguation between the set of gestures that you request. For example, if you request just Tap, the user may hold their finger down as long as they like and a Tap will still occur when the user releases their finger. If you request both Tap and Hold, after about a second of holding down their finger, the gesture will resolve to a Hold and a Tap will no longer occur.

Manipulation settings may not be combined with Navigation settings.

See also

• Spatial interaction source sample