| Top | |
|
|
|
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, double start_x, double 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, double offset_x, double 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, double offset_x, double 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