Package: gtk

Enum gtk-propagation-phase

Details

Describes the stage at which events are fed into a gtk-event-controller.
(define-g-enum "GtkPropagationPhase" gtk-propagation-phase
  (:export t
   :type-initializer "gtk_propagation_phase_get_type")
  (:phase-none 0)
  (:phase-capture 1)
  (:phase-bubble 2)
  (:phase-target 3))  
:phase-none
Events are not delivered automatically. Those can be manually fed through the function gtk-event-controller-handle-event. This should only be used when full control about when, or whether the controller handles the event is needed.
:phase-capture
Events are delivered in the capture phase. The capture phase happens before the bubble phase, runs from the toplevel down to the event widget. This option should only be used on containers that might possibly handle events before their children do.
:phase-bubble
Events are delivered in the bubble phase. The bubble phase happens after the capture phase, and before the default handlers are run. This phase runs from the event widget, up to the toplevel.
:phase-target
Events are delivered in the default widget event handlers, note that widget implementations must chain up on button, motion, touch and grab broken handlers for controllers in this phase to be run.
 

See also

2020-9-10