Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-14585

Qt gesture documentation is unclear on what is an active gesture

    XMLWordPrintable

Details

    • Bug
    • Resolution: Out of scope
    • P2: Important
    • 4.8.x
    • 4.7.0
    • Documentation
    • None

    Description

      The gesture framework documentation should explicitly define the meaning of "active" gestures. In the current implementation, gestures are "active" / "being executed" when a state change has been triggered by the corresponding gesture recognizer. In particular, the QGestureEvent::activeGestures() does not return the list of all grabbed && started && accepted gestures, but only those that actually had a state change.

      Only definition in the documentation for "active" is "The gestures are either active or canceled. ", which would hint (in combination of ::activeGestures() documentation "Returns a list of active (not canceled) gestures.") that if no cancel has been received, the gesture is obtainable through the event.

      It could be argued, however, that it would be nice from receiver state management point of view to have list of all gestures which the current recipient has accepted, but that would require an additional enumeration value/flag to specify a non-updated gesture.

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            jerome.pasion Jerome Pasion
            mikkohar Mikko Harju
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes