GtkGestureClick — Multipress gesture
void | pressed | Run Last |
void | released | Run Last |
void | stopped | Run Last |
void | unpaired-release | Run Last |
GObject ╰── GtkEventController ╰── GtkGesture ╰── GtkGestureSingle ╰── GtkGestureClick
#include <gtk/gtk.h>
GtkGestureClick is a GtkGesture implementation able to recognize multiple clicks on a nearby zone, which can be listened for through the “pressed” signal. Whenever time or distance between clicks exceed the GTK defaults, “stopped” is emitted, and the click counter is reset.
GtkGesture *
gtk_gesture_click_new (void
);
Returns a newly created GtkGesture that recognizes single and multiple presses.
a newly created GtkGestureClick
typedef struct _GtkGestureClick GtkGestureClick;
“pressed”
signalvoid user_function (GtkGestureClick *gesture, int n_press, double x, double y, gpointer user_data)
This signal is emitted whenever a button or touch press happens.
gesture | the object which received the signal | |
n_press | how many touch/button presses happened with this one | |
x | The X coordinate, in widget allocation coordinates | |
y | The Y coordinate, in widget allocation coordinates | |
user_data | user data set when the signal handler was connected. |
Flags: Run Last
“released”
signalvoid user_function (GtkGestureClick *gesture, int n_press, double x, double y, gpointer user_data)
This signal is emitted when a button or touch is released. n_press
will report the number of press that is paired to this event, note that “stopped” may have been emitted between the press and its release, n_press
will only start over at the next press.
gesture | the object which received the signal | |
n_press | number of press that is paired with this release | |
x | The X coordinate, in widget allocation coordinates | |
y | The Y coordinate, in widget allocation coordinates | |
user_data | user data set when the signal handler was connected. |
Flags: Run Last
“stopped”
signalvoid user_function (GtkGestureClick *gesture, gpointer user_data)
This signal is emitted whenever any time/distance threshold has been exceeded.
gesture | the object which received the signal | |
user_data | user data set when the signal handler was connected. |
Flags: Run Last
“unpaired-release”
signalvoid user_function (GtkGestureClick *gesture, double x, double y, guint button, GdkEventSequence *sequence, gpointer user_data)
This signal is emitted whenever the gesture receives a release event that had no previous corresponding press. Due to implicit grabs, this can only happen on situations where input is grabbed elsewhere mid-press or the pressed widget voluntarily relinquishes its implicit grab.
gesture | the object which received the signal | |
x | X coordinate of the event | |
y | Y coordinate of the event | |
button | Button being released | |
sequence | Sequence being released | |
user_data | user data set when the signal handler was connected. |
Flags: Run Last
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk4/4.0/GtkGestureClick.html