The gdk-touchpad-gesture-phase enumeration specifies the current state of a touchpad gesture. All gestures are guaranteed to begin with an event with :begin phase, followed by 0 or several events with :update phase.

A finished gesture may have 2 possible outcomes, an event with :end phase will be emitted when the gesture is considered successful, this should be used as the hint to perform any permanent changes.

Cancelled gestures may be so for a variety of reasons, due to hardware or the compositor, or due to the gesture recognition layers hinting the gesture did not finish resolutely, e.g. a 3rd finger being added during a pinch gesture. In these cases, the last event will report the :cancel phase, this should be used as a hint to undo any visible/permanent changes that were done throughout the progress of the gesture.

(define-g-enum "GdkTouchpadGesturePhase" gdk-touchpad-gesture-phase
  (:export t
   :type-initializer "gdk_touchpad_gesture_phase_get_type")
  (:begin 0)
  (:update 1)
  (:end 2)
  (:cancel 3))  

:begin

The gesture has begun.

:update

The gesture has been updated.

:end

The gesture was finished, changes should be permanently applied.

:cancel

The gesture was cancelled, all changes should be undone.