| OLD | NEW |
| (Empty) |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef CONTENT_BROWSER_RENDERER_HOST_INPUT_GESTURE_EVENT_QUEUE_H_ | |
| 6 #define CONTENT_BROWSER_RENDERER_HOST_INPUT_GESTURE_EVENT_QUEUE_H_ | |
| 7 | |
| 8 #include <deque> | |
| 9 #include <queue> | |
| 10 | |
| 11 #include "content/browser/renderer_host/input/gesture_event_packet.h" | |
| 12 #include "content/common/content_export.h" | |
| 13 #include "content/port/common/input_event_ack_state.h" | |
| 14 #include "third_party/WebKit/public/web/WebInputEvent.h" | |
| 15 | |
| 16 namespace content { | |
| 17 | |
| 18 // Interface with which the |GestureEventQueue| forwards gestures for a given | |
| 19 // touch event. | |
| 20 class CONTENT_EXPORT GestureEventQueueClient { | |
| 21 public: | |
| 22 virtual void ForwardGestureEvent(const blink::WebGestureEvent&) = 0; | |
| 23 }; | |
| 24 | |
| 25 // Handles dispatch of touch-derived gestures created by the platform. | |
| 26 // Gestures are forwarded or dropped depending on the ack dispositions of the | |
| 27 // generating touch sequence. | |
| 28 class CONTENT_EXPORT GestureEventQueue { | |
| 29 public: | |
| 30 explicit GestureEventQueue(GestureEventQueueClient* client); | |
| 31 ~GestureEventQueue(); | |
| 32 | |
| 33 // To be called upon receipt of gesture-related events. In particular, | |
| 34 // |packet| contains [0, n] gestures that correspond to a given event. That | |
| 35 // event may be a touch, or a touch timeout for certain stationary gestures. | |
| 36 // It is imperative that a single packet is received for *each* touch event, | |
| 37 // even those that did not produce a gesture. | |
| 38 void OnGestureEventPacket(const GestureEventPacket& packet); | |
| 39 | |
| 40 // To be called upon receipt of *all* touch event acks. | |
| 41 void OnTouchEventAck(InputEventAckState ack_state); | |
| 42 | |
| 43 private: | |
| 44 // Utility class for tracking gesture events and dispositions for a single | |
| 45 // gesture sequence. A single sequence corresponds to all gestures created | |
| 46 // between the first finger down and the last finger up, including gestures | |
| 47 // generated by timeouts from a statinoary finger. | |
| 48 class GestureSequence { | |
| 49 public: | |
| 50 GestureSequence(); | |
| 51 ~GestureSequence(); | |
| 52 | |
| 53 void Push(const GestureEventPacket& packet); | |
| 54 void Pop(); | |
| 55 const GestureEventPacket& Front() const; | |
| 56 void UpdateState(InputEventAckState ack_state); | |
| 57 bool IsGesturePrevented() const; | |
| 58 bool IsEmpty() const; | |
| 59 | |
| 60 private: | |
| 61 std::queue<GestureEventPacket> packets_; | |
| 62 enum GestureHandlingState { | |
| 63 PENDING, // The sequence has yet to receive an ack. | |
| 64 ALLOWED_UNTIL_PREVENTED, // Gestures in the sequence are allowed until | |
| 65 // a source touch is preventDefault'ed. | |
| 66 ALWAYS_ALLOWED, // All remaining sequence gestures are forwarded. | |
| 67 ALWAYS_PREVENTED // All remaining sequence gestures are dropped. | |
| 68 }; | |
| 69 GestureHandlingState state_; | |
| 70 }; | |
| 71 void UpdateAndDispatchPackets(GestureSequence* sequence, | |
| 72 InputEventAckState ack_result); | |
| 73 void SendPacket(const GestureEventPacket& packet); | |
| 74 void SendGesture(const blink::WebGestureEvent& gesture); | |
| 75 void CancelTapIfNecessary(); | |
| 76 void CancelFlingIfNecessary(); | |
| 77 GestureSequence& Head(); | |
| 78 GestureSequence& Tail(); | |
| 79 | |
| 80 GestureEventQueueClient* client_; | |
| 81 std::queue<GestureSequence> sequences_; | |
| 82 | |
| 83 // Bookkeeping for inserting synthetic Gesture{Tap,Fling}Cancel events | |
| 84 // when necessary, e.g., GestureTapCancel when scrolling begins, or | |
| 85 // GestureFlingCancel when a user taps following a GestureFlingStart. | |
| 86 bool needs_tap_ending_event_; | |
| 87 bool needs_fling_ending_event_; | |
| 88 | |
| 89 DISALLOW_COPY_AND_ASSIGN(GestureEventQueue); | |
| 90 }; | |
| 91 | |
| 92 } // namespace content | |
| 93 | |
| 94 #endif // CONTENT_BROWSER_RENDERER_HOST_INPUT_GESTURE_EVENT_QUEUE_H_ | |
| OLD | NEW |