[gtk+/gestures: 133/202] gesture: Add explanatory note in GtkGesture::end



commit db55f8a4e54f6151b6d64bb2dd030fd19e5c269e
Author: Carlos Garnacho <carlosg gnome org>
Date:   Tue May 6 15:23:24 2014 +0200

    gesture: Add explanatory note in GtkGesture::end
    
    Explain that this signal may be triggered by an extra touch that causes
    the gesture to surpass GtkGesture:n-points.

 gtk/gtkgesture.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkgesture.c b/gtk/gtkgesture.c
index 924b9ce..fd72f20 100644
--- a/gtk/gtkgesture.c
+++ b/gtk/gtkgesture.c
@@ -653,6 +653,11 @@ gtk_gesture_class_init (GtkGestureClass *klass)
    * #FALSE), or the number of touch sequences became higher or lower than
    * #GtkGesture:n-points.
    *
+   * Note: @sequence might not pertain to the group of sequences that were
+   * previously triggering recognition on @gesture (ie. a just pressed touch
+   * sequence that exceeds #GtkGesture:n-points). This situation may be detected
+   * by checking through gtk_gesture_handles_sequence().
+   *
    * Since: 3.14
    */
   signals[END] =


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]