Gtk.EventController¶

Subclasses:	`Gtk.EventControllerKey`, `Gtk.EventControllerMotion`, `Gtk.EventControllerScroll`, `Gtk.Gesture`, `Gtk.PadController`

Methods¶

Inherited:	GObject.Object (37)
Structs:	GObject.ObjectClass (5)

	`get_propagation_phase` ()
	`get_widget` ()
	`handle_event` (event)
	`reset` ()
	`set_propagation_phase` (phase)

Virtual Methods¶

Inherited:	GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`propagation-phase`	`Gtk.PropagationPhase`	r/w/en	Propagation phase at which this controller is run
`widget`	`Gtk.Widget`	r/w/co	Widget the gesture relates to

Signals¶

Inherited:	GObject.Object (1)

Fields¶

Inherited:	GObject.Object (1)

Class Details¶

class Gtk.EventController(**kwargs)¶

Bases:	`GObject.Object`
Abstract:	Yes
Structure:	`Gtk.EventControllerClass`

Gtk.EventController is a base, low-level implementation for event controllers. Those react to a series of Gdk.Events, and possibly trigger actions as a consequence of those.

get_propagation_phase()[source]¶

Returns:	the propagation phase
Return type:	`Gtk.PropagationPhase`

Gets the propagation phase at which self handles events.

New in version 3.14.

get_widget()[source]¶

Returns:	a `Gtk.Widget`
Return type:	`Gtk.Widget`

Returns the Gtk.Widget this controller relates to.

New in version 3.14.

handle_event(event)[source]¶

Parameters:	event (`Gdk.Event`) – a `Gdk.Event`
Returns:	`True` if the event was potentially useful to trigger the controller action
Return type:	`bool`

Feeds an events into self, so it can be interpreted and the controller actions triggered.

New in version 3.14.

reset()[source]¶: Resets the self to a clean state. Every interaction the controller did through Gtk.EventController ::handle-event will be dropped at this point.

New in version 3.14.

set_propagation_phase(phase)[source]¶

Parameters:	phase (`Gtk.PropagationPhase`) – a propagation phase

Sets the propagation phase at which a controller handles events.

If phase is Gtk.PropagationPhase.NONE, no automatic event handling will be performed, but other additional gesture maintenance will. In that phase, the events can be managed by calling Gtk.EventController.handle_event().

New in version 3.14.

Property Details¶

Gtk.EventController.props.propagation_phase¶

Name:	`propagation-phase`
Type:	`Gtk.PropagationPhase`
Default Value:	`Gtk.PropagationPhase.BUBBLE`
Flags:	`READABLE`, `WRITABLE`, `EXPLICIT_NOTIFY`

The propagation phase at which this controller will handle events.

New in version 3.14.

Gtk.EventController.props.widget¶

Name:	`widget`
Type:	`Gtk.Widget`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`, `CONSTRUCT_ONLY`

The widget receiving the Gdk.Events that the controller will handle.

New in version 3.14.