diff options
author | Matthias Clasen <mclasen@redhat.com> | 2021-03-01 01:48:45 -0500 |
---|---|---|
committer | Emmanuele Bassi <ebassi@gnome.org> | 2021-03-11 16:37:37 +0000 |
commit | 4e4050813a8365c257a2d5c1611ed024c8144197 (patch) | |
tree | 5d3757ede53cd7ea8848a3d09df9ea170cb9d931 /gtk/gtkgestureswipe.c | |
parent | 2d55e3343ac0fab82237071ab9781516a349126a (diff) | |
download | gtk+-4e4050813a8365c257a2d5c1611ed024c8144197.tar.gz |
gestureswipe: Convert docs
Diffstat (limited to 'gtk/gtkgestureswipe.c')
-rw-r--r-- | gtk/gtkgestureswipe.c | 41 |
1 files changed, 22 insertions, 19 deletions
diff --git a/gtk/gtkgestureswipe.c b/gtk/gtkgestureswipe.c index 56de01c221..ac52638298 100644 --- a/gtk/gtkgestureswipe.c +++ b/gtk/gtkgestureswipe.c @@ -19,18 +19,18 @@ */ /** - * SECTION:gtkgestureswipe - * @Short_description: Swipe gesture - * @Title: GtkGestureSwipe + * GtkGestureSwipe: * - * #GtkGestureSwipe is a #GtkGesture implementation able to recognize - * swipes, after a press/move/.../move/release sequence happens, the - * #GtkGestureSwipe::swipe signal will be emitted, providing the velocity - * and directionality of the sequence at the time it was lifted. + * `GtkGestureSwipe` is a `GtkGesture` for swipe gestures. + * + * After a press/move/.../move/release sequence happens, the + * [signal@Gtk.GestureSwipe::swipe] signal will be emitted, + * providing the velocity and directionality of the sequence + * at the time it was lifted. * * If the velocity is desired in intermediate points, - * gtk_gesture_swipe_get_velocity() can be called on eg. a - * #GtkGesture::update handler. + * [method@Gtk.GestureSwipe.get_velocity] can be called in a + * [signal@Gtk.Gesture::update] handler. * * All velocities are reported in pixels/sec units. */ @@ -240,8 +240,9 @@ gtk_gesture_swipe_class_init (GtkGestureSwipeClass *klass) * @velocity_x: velocity in the X axis, in pixels/sec * @velocity_y: velocity in the Y axis, in pixels/sec * - * This signal is emitted when the recognized gesture is finished, velocity - * and direction are a product of previously recorded events. + * Emitted when the recognized gesture is finished. + * + * Velocity and direction are a product of previously recorded events. */ signals[SWIPE] = g_signal_new (I_("swipe"), @@ -268,10 +269,10 @@ gtk_gesture_swipe_init (GtkGestureSwipe *gesture) /** * gtk_gesture_swipe_new: * - * Returns a newly created #GtkGesture that recognizes swipes. + * Returns a newly created `GtkGesture` that recognizes swipes. * - * Returns: a newly created #GtkGestureSwipe - **/ + * Returns: a newly created `GtkGestureSwipe` + */ GtkGesture * gtk_gesture_swipe_new (void) { @@ -281,16 +282,18 @@ gtk_gesture_swipe_new (void) /** * gtk_gesture_swipe_get_velocity: - * @gesture: a #GtkGestureSwipe + * @gesture: a `GtkGestureSwipe` * @velocity_x: (out): return value for the velocity in the X axis, in pixels/sec * @velocity_y: (out): return value for the velocity in the Y axis, in pixels/sec * - * If the gesture is recognized, this function returns %TRUE and fill in - * @velocity_x and @velocity_y with the recorded velocity, as per the - * last event(s) processed. + * Gets the current velocity. + * + * If the gesture is recognized, this function returns %TRUE and fills + * in @velocity_x and @velocity_y with the recorded velocity, as per the + * last events processed. * * Returns: whether velocity could be calculated - **/ + */ gboolean gtk_gesture_swipe_get_velocity (GtkGestureSwipe *gesture, double *velocity_x, |