GtkGesturePan — Pan gesture
GtkOrientation | orientation | Read / Write |
void | pan | Run Last |
GObject ╰── GtkEventController ╰── GtkGesture ╰── GtkGestureSingle ╰── GtkGestureDrag ╰── GtkGesturePan
#include <gtk/gtk.h>
GtkGesturePan is a GtkGesture implementation able to recognize pan gestures, those are drags that are locked to happen along one axis. The axis that a GtkGesturePan handles is defined at construct time, and can be changed through gtk_gesture_pan_set_orientation()
.
When the gesture starts to be recognized, GtkGesturePan will attempt to determine as early as possible whether the sequence is moving in the expected direction, and denying the sequence if this does not happen.
Once a panning gesture along the expected axis is recognized, the “pan” signal will be emitted as input events are received, containing the offset in the given axis.
GtkGesture *
gtk_gesture_pan_new (GtkOrientation orientation
);
Returns a newly created GtkGesture that recognizes pan gestures.
orientation | expected orientation |
a newly created GtkGesturePan
GtkOrientation
gtk_gesture_pan_get_orientation (GtkGesturePan *gesture
);
Returns the orientation of the pan gestures that this gesture
expects.
gesture |
the expected orientation for pan gestures
void gtk_gesture_pan_set_orientation (GtkGesturePan *gesture
,GtkOrientation orientation
);
Sets the orientation to be expected on pan gestures.
gesture | ||
orientation | expected orientation |
typedef struct _GtkGesturePan GtkGesturePan;
Describes the panning direction of a GtkGesturePan
GTK_PAN_DIRECTION_LEFT | panned towards the left | |
GTK_PAN_DIRECTION_RIGHT | panned towards the right | |
GTK_PAN_DIRECTION_UP | panned upwards | |
GTK_PAN_DIRECTION_DOWN | panned downwards |
“orientation”
property“orientation” GtkOrientation
The expected orientation of pan gestures.
Owner: GtkGesturePan
Flags: Read / Write
Default value: GTK_ORIENTATION_HORIZONTAL
“pan”
signalvoid user_function (GtkGesturePan *gesture, GtkPanDirection direction, double offset, gpointer user_data)
This signal is emitted once a panning gesture along the expected axis is detected.
gesture | The object which received the signal | |
direction | current direction of the pan gesture | |
offset | Offset along the gesture orientation | |
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/GtkGesturePan.html