Interface IGestureEvents

Namespace

Icy.Input.Gestures

Assembly

IcyUI.dll

Represents the gestures recognized from touch contacts and mouse buttons - the single source of pointer gestures on every engine.

public interface IGestureEvents : IInputEventProvider, IUpdateableInput, IInitializable

Inherited Members

IInputEventProvider.InputSystem

IUpdateableInput.Update(TimeSpan)

IInitializable.IsInitialized

IInitializable.Initialize()

Extension Methods

PropertyReferencesExtensions.ContainsProperty(object, IPropertyReference)

Remarks

Engines only report raw contacts (Contacts) and mouse buttons. Recognition happens here, so thresholds and behavior are identical everywhere. All positions are in physical pixels.

Per pointer kind (see PointerKind):

• Touch and MouseLeft tap, hold and drag.
• MouseRight raises Held on release.
• MouseMiddle only drags.
• Two touch contacts pinch. A second finger cancels the first finger's drag; after a pinch, the remaining fingers stay inert until all are lifted.

Mouse presses are ignored while any touch contact is active and for a short moment after the last one lifts, because the OS synthesizes mouse input from touch (on Windows, a tap's click arrives after the finger lifts). Mouse releases always go through, so a button pressed before the touch began still ends its gesture.

Properties

Settings

Gets the recognition thresholds.

GestureSettings Settings { get; }

Property Value

GestureSettings

Events

DragCanceled

Occurs when a drag ends without a release - a second finger started a pinch, or the contact vanished.

event EventHandler<GenericEventArgs<DragInfo>>? DragCanceled

Event Type

EventHandler<GenericEventArgs<DragInfo>>

DragCompleted

Occurs when a dragging pointer is released. Velocity holds the release velocity.

event EventHandler<GenericEventArgs<DragInfo>>? DragCompleted

Event Type

EventHandler<GenericEventArgs<DragInfo>>

DragMoved

Occurs when a dragging pointer moves.

event EventHandler<GenericEventArgs<DragInfo>>? DragMoved

Event Type

EventHandler<GenericEventArgs<DragInfo>>

DragStarted

Occurs when a press moves past Slop. Set Cancel to reject the drag: no further drag events are raised for that press.

event EventHandler<AcceptableEventArgs<DragInfo>>? DragStarted

Event Type

EventHandler<AcceptableEventArgs<DragInfo>>

Held

Occurs when a touch or left-mouse press stays inside Slop for HoldDelay, or when the right mouse button is released.

event EventHandler<GenericEventArgs<PointerInfo>>? Held

Event Type

EventHandler<GenericEventArgs<PointerInfo>>

PinchChanged

Occurs when a pinching finger moves.

event EventHandler<GenericEventArgs<PinchInfo>>? PinchChanged

Event Type

EventHandler<GenericEventArgs<PinchInfo>>

PinchCompleted

Occurs when either pinching finger is lifted or vanishes.

event EventHandler<GenericEventArgs<PinchInfo>>? PinchCompleted

Event Type

EventHandler<GenericEventArgs<PinchInfo>>

PinchStarted

Occurs when a second touch contact lands and a pinch begins.

event EventHandler<GenericEventArgs<PinchInfo>>? PinchStarted

Event Type

EventHandler<GenericEventArgs<PinchInfo>>

PointerPressed

Occurs when a pointer is pressed.

event EventHandler<GenericEventArgs<PointerInfo>>? PointerPressed

Event Type

EventHandler<GenericEventArgs<PointerInfo>>

PointerReleased

Occurs when a pointer is released, or its contact vanished.

event EventHandler<GenericEventArgs<PointerInfo>>? PointerReleased

Event Type

EventHandler<GenericEventArgs<PointerInfo>>

Tapped

Occurs when a pointer is released inside Slop before HoldDelay.

event EventHandler<GenericEventArgs<TapInfo>>? Tapped

Event Type

EventHandler<GenericEventArgs<TapInfo>>