Details
-
Bug
-
Resolution: Out of scope
-
P2: Important
-
4.7.0
-
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.