Top | ![]() |
![]() |
![]() |
![]() |
void | pressed | Run Last |
void | released | Run Last |
void | stopped | Run Last |
void | unpaired-release | Run Last |
GObject ╰── GtkEventController ╰── GtkGesture ╰── GtkGestureSingle ╰── GtkGestureClick
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.
“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