GtkEventController

GtkEventController — Self-contained handler of series of events

Functions

Properties

gchar * name Read / Write
GtkPropagationLimit propagation-limit Read / Write
GtkPropagationPhase propagation-phase Read / Write
GtkWidget * widget Read

Types and Values

Object Hierarchy

    GObject
    ╰── GtkEventController
        ├── GtkGesture
        ├── GtkDropTarget
        ├── GtkEventControllerKey
        ├── GtkEventControllerLegacy
        ├── GtkEventControllerMotion
        ├── GtkEventControllerScroll
        ╰── GtkPadController

Includes

#include <gtk/gtk.h>

Description

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

Functions

gtk_event_controller_get_propagation_phase ()

GtkPropagationPhase
gtk_event_controller_get_propagation_phase
                               (GtkEventController *controller);

Gets the propagation phase at which controller handles events.

Parameters

controller

a GtkEventController

 

Returns

the propagation phase


gtk_event_controller_set_propagation_phase ()

void
gtk_event_controller_set_propagation_phase
                               (GtkEventController *controller,
                                GtkPropagationPhase phase);

Sets the propagation phase at which a controller handles events.

If phase is GTK_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 gtk_event_controller_handle_event().

Parameters

controller

a GtkEventController

 

phase

a propagation phase

 

gtk_event_controller_get_propagation_limit ()

GtkPropagationLimit
gtk_event_controller_get_propagation_limit
                               (GtkEventController *controller);

gtk_event_controller_set_propagation_limit ()

void
gtk_event_controller_set_propagation_limit
                               (GtkEventController *controller,
                                GtkPropagationLimit limit);

gtk_event_controller_handle_event ()

gboolean
gtk_event_controller_handle_event (GtkEventController *controller,
                                   const GdkEvent *event);

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

Parameters

controller

a GtkEventController

 

event

a GdkEvent

 

Returns

TRUE if the event was potentially useful to trigger the controller action


gtk_event_controller_get_widget ()

GtkWidget *
gtk_event_controller_get_widget (GtkEventController *controller);

Returns the GtkWidget this controller relates to.

Parameters

controller

a GtkEventController

 

Returns

a GtkWidget.

[transfer none]


gtk_event_controller_reset ()

void
gtk_event_controller_reset (GtkEventController *controller);

Resets the controller to a clean state. Every interaction the controller did through gtk_event_controll_handle_event() will be dropped at this point.

Parameters

controller

a GtkEventController

 

Property Details

The “name” property

  “name”                     gchar *

Name for this controller.

Owner: GtkEventController

Flags: Read / Write

Default value: NULL


The “propagation-limit” property

  “propagation-limit”        GtkPropagationLimit

The limit for which events this controller will handle.

Owner: GtkEventController

Flags: Read / Write

Default value: GTK_LIMIT_SAME_NATIVE


The “propagation-phase” property

  “propagation-phase”        GtkPropagationPhase

The propagation phase at which this controller will handle events.

Owner: GtkEventController

Flags: Read / Write

Default value: GTK_PHASE_BUBBLE


The “widget” property

  “widget”                   GtkWidget *

The widget receiving the GdkEvents that the controller will handle.

Owner: GtkEventController

Flags: Read

See Also

GtkGesture