Top |
GtkGesture * | gtk_gesture_drag_new () |
gboolean | gtk_gesture_drag_get_start_point () |
gboolean | gtk_gesture_drag_get_offset () |
GObject ╰── GtkEventController ╰── GtkGesture ╰── GtkGestureSingle ╰── GtkGestureDrag ╰── GtkGesturePan
GtkGestureDrag is a GtkGesture implementation that recognizes drag
operations. The drag operation itself can be tracked throught the
“drag-begin”, “drag-update” and
“drag-end” signals, or the relevant coordinates be
extracted through gtk_gesture_drag_get_offset()
and
gtk_gesture_drag_get_start_point()
.
GtkGesture *
gtk_gesture_drag_new (GtkWidget *widget
);
Returns a newly created GtkGesture that recognizes drags.
Since: 3.14
gboolean gtk_gesture_drag_get_start_point (GtkGestureDrag *gesture
,gdouble *x
,gdouble *y
);
If the gesture
is active, this function returns TRUE
and fills in x
and y
with the drag start coordinates,
in window-relative coordinates.
gesture |
||
x |
X coordinate for the drag start point. |
[out][nullable] |
y |
Y coordinate for the drag start point. |
[out][nullable] |
Since: 3.14
gboolean gtk_gesture_drag_get_offset (GtkGestureDrag *gesture
,gdouble *x
,gdouble *y
);
If the gesture
is active, this function returns TRUE
and
fills in x
and y
with the coordinates of the current point,
as an offset to the starting drag point.
gesture |
||
x |
X offset for the current point. |
[out][nullable] |
y |
Y offset for the current point. |
[out][nullable] |
Since: 3.14
“drag-begin”
signalvoid user_function (GtkGestureDrag *gesture, gdouble start_x, gdouble start_y, gpointer user_data)
This signal is emitted whenever dragging starts.
gesture |
the object which received the signal |
|
start_x |
X coordinate, relative to the widget allocation |
|
start_y |
Y coordinate, relative to the widget allocation |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 3.14
“drag-end”
signalvoid user_function (GtkGestureDrag *gesture, gdouble offset_x, gdouble offset_y, gpointer user_data)
This signal is emitted whenever the dragging is finished.
gesture |
the object which received the signal |
|
offset_x |
X offset, relative to the start point |
|
offset_y |
Y offset, relative to the start point |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 3.14
“drag-update”
signalvoid user_function (GtkGestureDrag *gesture, gdouble offset_x, gdouble offset_y, gpointer user_data)
This signal is emitted whenever the dragging point moves.
gesture |
the object which received the signal |
|
offset_x |
X offset, relative to the start point |
|
offset_y |
Y offset, relative to the start point |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 3.14