Package org.gnome.gtk

Class EventController

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtk.EventController

All Implemented Interfaces:

Proxy

Direct Known Subclasses:

DropControllerMotion, DropTarget, DropTargetAsync, EventController.EventController$Impl, EventControllerFocus, EventControllerKey, EventControllerLegacy, EventControllerMotion, EventControllerScroll, Gesture, PadController, ShortcutController

@Generated("io.github.jwharm.JavaGI")
public abstract class EventController
extends GObject

The base class for event controllers.

These are ancillary objects associated to widgets, which react to GdkEvents, and possibly trigger actions as a consequence.

Event controllers are added to a widget with Widget.addController(org.gnome.gtk.EventController). It is rarely necessary to explicitly remove a controller with Widget.removeController(org.gnome.gtk.EventController).

See the chapter on input handling for an overview of the basic concepts, such as the capture and bubble phases of event propagation.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	EventController.Builder<B extends EventController.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	EventController.EventController$Impl	The EventController$Impl type represents a native instance of the abstract EventController class.
static class	EventController.EventControllerClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
EventController()	Creates a new EventController.
EventController(MemorySegment address)	Create a EventController proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected EventController	asParent()	Returns this instance as if it were its parent type.
@Nullable Event	getCurrentEvent()	Returns the event that is currently being handled by the controller.
@Nullable Device	getCurrentEventDevice()	Returns the device of the event that is currently being handled by the controller.
Set<ModifierType>	getCurrentEventState()	Returns the modifier state of the event that is currently being handled by the controller.
int	getCurrentEventTime()	Returns the timestamp of the event that is currently being handled by the controller.
@Nullable String	getName()	Gets the name of controller.
PropagationLimit	getPropagationLimit()	Gets the propagation limit of the event controller.
PropagationPhase	getPropagationPhase()	Gets the propagation phase at which this EventController handles events.
static @Nullable Type	getType()	Get the GType of the EventController class
@Nullable Widget	getWidget()	Returns the GtkWidget this controller relates to.
void	reset()	Resets the this EventController to a clean state.
void	setName(@Nullable String name)	Sets a name on the controller that can be used for debugging.
void	setPropagationLimit(PropagationLimit limit)	Sets the event propagation limit on the event controller.
void	setPropagationPhase(PropagationPhase phase)	Sets the propagation phase at which a controller handles events.
void	setStaticName(@Nullable String name)	Sets a name on the controller that can be used for debugging.

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, builder, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getMemoryLayout, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

EventController

public EventController(MemorySegment address)

Create a EventController proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

EventController

public EventController()

Creates a new EventController.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the EventController class

Returns:

the GType

asParent

protected EventController asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GObject

getCurrentEvent

public @Nullable Event getCurrentEvent()

Returns the event that is currently being handled by the controller.

At other times, null is returned.

Returns:

the event that is currently handled by this EventController

getCurrentEventDevice

public @Nullable Device getCurrentEventDevice()

Returns the device of the event that is currently being handled by the controller.

At other times, null is returned.

Returns:

device of the event is currently handled by this EventController

getCurrentEventState

public Set<ModifierType> getCurrentEventState()

Returns the modifier state of the event that is currently being handled by the controller.

At other times, 0 is returned.

Returns:

modifier state of the event is currently handled by this EventController

getCurrentEventTime

public int getCurrentEventTime()

Returns the timestamp of the event that is currently being handled by the controller.

At other times, 0 is returned.

Returns:

timestamp of the event is currently handled by this EventController

getName

public @Nullable String getName()

Gets the name of controller.

Returns:

The controller name

getPropagationLimit

public PropagationLimit getPropagationLimit()

Gets the propagation limit of the event controller.

Returns:

the propagation limit

getPropagationPhase

public PropagationPhase getPropagationPhase()

Gets the propagation phase at which this EventController handles events.

Returns:

the propagation phase

getWidget

public @Nullable Widget getWidget()

Returns the GtkWidget this controller relates to.

Returns:

a GtkWidget

reset

public void reset()

Resets the this EventController to a clean state.

setName

public void setName(@Nullable String name)

Sets a name on the controller that can be used for debugging.

Parameters:

name - a name for this EventController

setPropagationLimit

public void setPropagationLimit(PropagationLimit limit)

Sets the event propagation limit on the event controller.

If the limit is set to PropagationLimit.SAME_NATIVE, the controller won't handle events that are targeted at widgets on a different surface, such as popovers.

Parameters:

limit - the propagation limit

setPropagationPhase

public void setPropagationPhase(PropagationPhase phase)

Sets the propagation phase at which a controller handles events.

If phase is PropagationPhase.NONE, no automatic event handling will be performed, but other additional gesture maintenance will.

Parameters:

phase - a propagation phase

setStaticName

public void setStaticName(@Nullable String name)

Sets a name on the controller that can be used for debugging.

Parameters:

name - a name for controller, must be a static string

Since:

4.8