Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CrossSlidingState enumeration

Applies to Windows and Windows Phone

Specifies the possible states of the CrossSliding event.

Syntax


Public Enum CrossSlidingState

Attributes

[Version(0x06020000)]

Members

The CrossSlidingState enumeration has these members.

MemberValueDescription
Started | started0

A CrossSliding interaction has been detected.

Dragging | dragging1

A CrossSliding interaction has started but the swipe or slide gesture has not crossed the minimum distance threshold for a selection action. (See the Remarks section for a diagram showing the CrossSliding distance thresholds.)

Note  There is no correlation between Dragging in CrossSlidingState (touch) and DraggingState (mouse or pen/stylus).

Selecting | selecting2

The swipe or slide gesture has crossed the minimum distance threshold for a selection action but has not crossed the minimum distance threshold of the rearrange action. This state is valid only when SpeedBumpStart is disabled in a GestureRecognizer.

SelectSpeedBumping | selectSpeedBumping3

The swipe or slide gesture has crossed the minimum distance threshold for a selection action (and the selection speed bump) but has not crossed the maximum distance threshold of the selection speed bump. This state is valid only when both SpeedBumpStart and SelectionStart are enabled in a GestureRecognizer.

SpeedBumping | speedBumping4

The swipe or slide gesture has crossed the minimum distance threshold for a selection action (and the selection speed bump) but has not crossed the maximum distance threshold of the selection speed bump. This state is valid only when SpeedBumpStart is enabled and SelectionStart is disabled in a GestureRecognizer.

Rearranging | rearranging5

The swipe or slide gesture has crossed the minimum distance threshold of the rearrange action. This state is valid only when RearrangeStart is enabled in a GestureRecognizer.

Completed | completed6

The swipe or slide gesture has stopped, the CrossSliding interaction has been completed, and the touch contact lifted.

Remarks

The CrossSlidingState property is set based on the distance thresholds specified by the CrossSlideThresholds property of a GestureRecognizer.

These distance thresholds are used to determine whether the CrossSliding interaction results in a select action or a rearrange action.

The following diagram shows the CrossSliding regions and thresholds. The areas highlighted in blue are the selection/speed bump regions. (The region on the left shows the distance the tile must travel while the region on the right shows the equivalent distance that the touch contact must travel due to the speed bump behavior).

Note  A speed bump is a CrossSliding region in which the user experiences a slight drag (or friction) during the swipe or slide gesture.

Screen shot showing CrossSlide regions and distance thresholds.

Selection, rearrange, and speed-bumps can be enabled or disabled in any combination through the CrossSlideThresholds property of a GestureRecognizer.

If SelectionStart and SpeedBumpStart are both enabled then SpeedBumpStart is ignored (friction is still experienced) and SelectSpeedBumping is returned when the swipe or slide gesture is detected within the selection/speed bumping region.

If SelectionStart is enabled and SpeedBumpStart is disabled then Selecting is returned when the swipe or slide gesture is detected within the selection/speed bump region.

If SpeedBumpStart and RearrangeStart are both enabled then SpeedBumpEnd is ignored and friction continues until the RearrangeStart threshold is reached.

If RearrangeStart is enabled then Rearranging is returned when the swipe or slide gesture is detected outside the selection/speed bumping region.

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

See also

CrossSlidingEventArgs.CrossSlidingState property
CrossSliding event
CrossSlideThresholds property

 

 

Show:
© 2014 Microsoft