| Top | |
|
|
|
| CtkPropagationPhase | propagation-phase | Read / Write |
| CtkWidget * | widget | Read / Write / Construct Only |
GObject
╰── CtkEventController
├── CtkEventControllerKey
├── CtkEventControllerMotion
├── CtkEventControllerScroll
├── CtkGesture
╰── CtkPadController
CtkEventController is a base, low-level implementation for event controllers. Those react to a series of CdkEvents, and possibly trigger actions as a consequence of those.
CtkPropagationPhase
ctk_event_controller_get_propagation_phase
(CtkEventController *controller);
Gets the propagation phase at which controller
handles events.
Since: 3.14
void ctk_event_controller_set_propagation_phase (CtkEventController *controller,CtkPropagationPhase phase);
Sets the propagation phase at which a controller handles events.
If phase
is CTK_PHASE_NONE, no automatic event handling will be
performed, but other additional gesture maintenance will. In that phase,
the events can be managed by calling ctk_event_controller_handle_event().
Since: 3.14
gboolean ctk_event_controller_handle_event (CtkEventController *controller,const CdkEvent *event);
Feeds an events into controller
, so it can be interpreted
and the controller actions triggered.
Since: 3.14
CtkWidget *
ctk_event_controller_get_widget (CtkEventController *controller);
Returns the CtkWidget this controller relates to.
Since: 3.14
void
ctk_event_controller_reset (CtkEventController *controller);
Resets the controller
to a clean state. Every interaction
the controller did through “handle-event”
will be dropped at this point.
Since: 3.14
Describes the stage at which events are fed into a CtkEventController.
|
Events are not delivered automatically. Those can be
manually fed through |
||
|
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. |
||
|
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. |
||
|
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. |
Since: 3.14
“propagation-phase” property“propagation-phase” CtkPropagationPhase
The propagation phase at which this controller will handle events.
Owner: CtkEventController
Flags: Read / Write
Default value: CTK_PHASE_BUBBLE
Since: 3.14