Class GestureDrag
- All Implemented Interfaces:
Proxy
- Direct Known Subclasses:
GesturePan
GtkGestureDrag
is a GtkGesture
implementation for drags.
The drag operation itself can be tracked throughout the
Gtk.GestureDrag::drag-begin
,
Gtk.GestureDrag::drag-update
and
Gtk.GestureDrag::drag-end
signals, and the relevant
coordinates can be extracted through
getOffset(io.github.jwharm.javagi.base.Out<java.lang.Double>, io.github.jwharm.javagi.base.Out<java.lang.Double>)
and
getStartPoint(io.github.jwharm.javagi.base.Out<java.lang.Double>, io.github.jwharm.javagi.base.Out<java.lang.Double>)
.
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
GestureDrag.Builder<B extends GestureDrag.Builder<B>>
Inner class implementing a builder pattern to construct a GObject with properties.static interface
Functional interface declaration of theDragBeginCallback
callback.static interface
Functional interface declaration of theDragEndCallback
callback.static interface
Functional interface declaration of theDragUpdateCallback
callback.static class
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 drags.GestureDrag
(MemorySegment address) Create a GestureDrag proxy instance for the provided memory address. -
Method Summary
Modifier and TypeMethodDescriptionprotected GestureDrag
asParent()
Returns this instance as if it were its parent type.static GestureDrag.Builder
<? extends GestureDrag.Builder> builder()
AGestureDrag.Builder
object constructs aGestureDrag
with the specified properties.void
emitDragBegin
(double startX, double startY) Emits the "drag-begin" signal.void
emitDragEnd
(double offsetX, double offsetY) Emits the "drag-end" signal.void
emitDragUpdate
(double offsetX, double offsetY) Emits the "drag-update" signal.boolean
Gets the offset from the start point.boolean
getStartPoint
(@Nullable Out<Double> x, @Nullable Out<Double> y) Gets the point where the drag started.static Type
getType()
Get the GType of the GestureDrag classonDragBegin
(GestureDrag.DragBeginCallback handler) Emitted whenever dragging starts.onDragEnd
(GestureDrag.DragEndCallback handler) Emitted whenever the dragging is finished.Emitted whenever the dragging point moves.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
-
GestureDrag
Create a GestureDrag proxy instance for the provided memory address.- Parameters:
address
- the memory address of the native object
-
GestureDrag
public GestureDrag()Returns a newly createdGtkGesture
that recognizes drags.
-
-
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
-
getOffset
Gets the offset from the start point.If the this GestureDrag is active, this function returns
true
and fills inx
andy
with the coordinates of the current point, as an offset to the starting drag point.- Parameters:
x
- X offset for the current pointy
- Y offset for the current point- Returns:
true
if the gesture is active
-
getStartPoint
Gets the point where the drag started.If the this GestureDrag is active, this function returns
true
and fills inx
andy
with the drag start coordinates, in widget-relative coordinates.- Parameters:
x
- X coordinate for the drag start pointy
- Y coordinate for the drag start point- Returns:
true
if the gesture is active
-
onDragBegin
public SignalConnection<GestureDrag.DragBeginCallback> onDragBegin(GestureDrag.DragBeginCallback handler) Emitted whenever dragging starts.- Parameters:
handler
- the signal handler- Returns:
- a signal handler ID to keep track of the signal connection
- See Also:
-
emitDragBegin
public void emitDragBegin(double startX, double startY) Emits the "drag-begin" signal. SeeonDragBegin(org.gnome.gtk.GestureDrag.DragBeginCallback)
. -
onDragEnd
Emitted whenever the dragging is finished.- Parameters:
handler
- the signal handler- Returns:
- a signal handler ID to keep track of the signal connection
- See Also:
-
emitDragEnd
public void emitDragEnd(double offsetX, double offsetY) Emits the "drag-end" signal. SeeonDragEnd(org.gnome.gtk.GestureDrag.DragEndCallback)
. -
onDragUpdate
public SignalConnection<GestureDrag.DragUpdateCallback> onDragUpdate(GestureDrag.DragUpdateCallback handler) Emitted whenever the dragging point moves.- Parameters:
handler
- the signal handler- Returns:
- a signal handler ID to keep track of the signal connection
- See Also:
-
emitDragUpdate
public void emitDragUpdate(double offsetX, double offsetY) Emits the "drag-update" signal. SeeonDragUpdate(org.gnome.gtk.GestureDrag.DragUpdateCallback)
. -
builder
AGestureDrag.Builder
object constructs aGestureDrag
with the specified properties. Use the variousset...()
methods to set properties, and finish construction withGestureDrag.Builder.build()
.
-