Package org.gnome.gtk
Class GestureLongPress
- All Implemented Interfaces:
Proxy
GtkGestureLongPress
is a GtkGesture
for long presses.
This gesture is also known as “Press and Hold”.
When the timeout is exceeded, the gesture is triggering the
Gtk.GestureLongPress::pressed
signal.
If the touchpoint is lifted before the timeout passes, or if
it drifts too far of the initial press point, the
Gtk.GestureLongPress::cancelled
signal will be emitted.
How long the timeout is before the ::pressed signal gets emitted is
determined by the Gtk.Settings:gtk-long-press-time
setting.
It can be modified by the Gtk.GestureLongPress:delay-factor
property.
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
GestureLongPress.Builder<B extends GestureLongPress.Builder<B>>
Inner class implementing a builder pattern to construct a GObject with properties.static interface
Functional interface declaration of theCancelledCallback
callback.static class
static interface
Functional interface declaration of thePressedCallback
callback.Nested classes/interfaces inherited from class org.gnome.gtk.GestureSingle
GestureSingle.GestureSingleClass
Nested classes/interfaces inherited from class org.gnome.gtk.Gesture
Gesture.BeginCallback, Gesture.CancelCallback, Gesture.EndCallback, Gesture.GestureClass, Gesture.GestureImpl, Gesture.SequenceStateChangedCallback, Gesture.UpdateCallback
Nested classes/interfaces inherited from class org.gnome.gtk.EventController
EventController.EventControllerClass, EventController.EventControllerImpl
Nested classes/interfaces inherited from class org.gnome.gobject.GObject
GObject.NotifyCallback, GObject.ObjectClass
-
Constructor Summary
ConstructorDescriptionReturns a newly createdGtkGesture
that recognizes long presses.GestureLongPress
(MemorySegment address) Create a GestureLongPress proxy instance for the provided memory address. -
Method Summary
Modifier and TypeMethodDescriptionprotected GestureLongPress
asParent()
Returns this instance as if it were its parent type.static GestureLongPress.Builder
<? extends GestureLongPress.Builder> builder()
AGestureLongPress.Builder
object constructs aGestureLongPress
with the specified properties.void
Emits the "cancelled" signal.void
emitPressed
(double x, double y) Emits the "pressed" signal.double
Returns the delay factor.static Type
getType()
Get the GType of the GestureLongPress classEmitted whenever a press moved too far, or was released beforeGtk.GestureLongPress::pressed
happened.Emitted whenever a press goes unmoved/unreleased longer than what the GTK defaults tell.void
setDelayFactor
(double delayFactor) Applies the given delay factor.Methods inherited from class org.gnome.gtk.GestureSingle
getButton, getCurrentButton, getCurrentSequence, getExclusive, getTouchOnly, setButton, setExclusive, setTouchOnly
Methods inherited from class org.gnome.gtk.Gesture
emitBegin, emitCancel, emitEnd, emitSequenceStateChanged, emitUpdate, getBoundingBox, getBoundingBoxCenter, getDevice, getGroup, getLastEvent, getLastUpdatedSequence, getPoint, getSequences, getSequenceState, group, handlesSequence, isActive, isGroupedWith, isRecognized, onBegin, onCancel, onEnd, onSequenceStateChanged, onUpdate, setSequenceState, setState, ungroup
Methods inherited from class org.gnome.gtk.EventController
getCurrentEvent, getCurrentEventDevice, getCurrentEventState, getCurrentEventTime, getName, getPropagationLimit, getPropagationPhase, getWidget, reset, setName, setPropagationLimit, setPropagationPhase, setStaticName
Methods inherited from class org.gnome.gobject.GObject
addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, 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, 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, getPrivate, readGClass, writeGClass
Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance
equals, handle, hashCode
-
Constructor Details
-
GestureLongPress
Create a GestureLongPress proxy instance for the provided memory address.- Parameters:
address
- the memory address of the native object
-
GestureLongPress
public GestureLongPress()Returns a newly createdGtkGesture
that recognizes long presses.
-
-
Method Details
-
getType
-
asParent
Returns this instance as if it were its parent type. This is mostly synonymous to the Javasuper
keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" withsuper.methodName()
doesn't work, because it invokes the overridden function pointer again. To chain up, callasParent().methodName()
. This will call the native function pointer of this virtual method in the typeclass of the parent type.- Overrides:
asParent
in classGestureSingle
-
getDelayFactor
public double getDelayFactor()Returns the delay factor.- Returns:
- the delay factor
-
setDelayFactor
public void setDelayFactor(double delayFactor) Applies the given delay factor.The default long press time will be multiplied by this value. Valid values are in the range [0.5..2.0].
- Parameters:
delayFactor
- The delay factor to apply
-
onCancelled
public SignalConnection<GestureLongPress.CancelledCallback> onCancelled(GestureLongPress.CancelledCallback handler) Emitted whenever a press moved too far, or was released beforeGtk.GestureLongPress::pressed
happened.- Parameters:
handler
- the signal handler- Returns:
- a signal handler ID to keep track of the signal connection
- See Also:
-
emitCancelled
public void emitCancelled()Emits the "cancelled" signal. SeeonCancelled(org.gnome.gtk.GestureLongPress.CancelledCallback)
. -
onPressed
public SignalConnection<GestureLongPress.PressedCallback> onPressed(GestureLongPress.PressedCallback handler) Emitted whenever a press goes unmoved/unreleased longer than what the GTK defaults tell.- Parameters:
handler
- the signal handler- Returns:
- a signal handler ID to keep track of the signal connection
- See Also:
-
emitPressed
public void emitPressed(double x, double y) Emits the "pressed" signal. SeeonPressed(org.gnome.gtk.GestureLongPress.PressedCallback)
. -
builder
AGestureLongPress.Builder
object constructs aGestureLongPress
with the specified properties. Use the variousset...()
methods to set properties, and finish construction withGestureLongPress.Builder.build()
.
-