1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_EVENTS_GESTURE_DETECTION_GESTURE_PROVIDER_H_
#define UI_EVENTS_GESTURE_DETECTION_GESTURE_PROVIDER_H_
#include "base/basictypes.h"
#include "base/memory/scoped_ptr.h"
#include "ui/events/gesture_detection/gesture_detection_export.h"
#include "ui/events/gesture_detection/gesture_detector.h"
#include "ui/events/gesture_detection/gesture_event_data.h"
#include "ui/events/gesture_detection/gesture_touch_uma_histogram.h"
#include "ui/events/gesture_detection/scale_gesture_detector.h"
#include "ui/events/gesture_detection/snap_scroll_controller.h"
#include "ui/gfx/display.h"
namespace ui {
class GESTURE_DETECTION_EXPORT GestureProviderClient {
public:
virtual ~GestureProviderClient() {}
virtual void OnGestureEvent(const GestureEventData& gesture) = 0;
};
// Given a stream of |MotionEvent|'s, provides gesture detection and gesture
// event dispatch.
class GESTURE_DETECTION_EXPORT GestureProvider {
public:
struct GESTURE_DETECTION_EXPORT Config {
Config();
~Config();
gfx::Display display;
GestureDetector::Config gesture_detector_config;
ScaleGestureDetector::Config scale_gesture_detector_config;
// If |disable_click_delay| is true and double-tap support is disabled,
// there will be no delay before tap events. When double-tap support is
// enabled, there will always be a delay before a tap event is fired, in
// order to allow the double tap gesture to occur without firing any tap
// events.
bool disable_click_delay;
// If |gesture_begin_end_types_enabled| is true, fire an ET_GESTURE_BEGIN
// event for every added touch point, and an ET_GESTURE_END event for every
// removed touch point. This requires one ACTION_CANCEL event to be sent per
// touch point, which only occurs on Aura. Defaults to false.
bool gesture_begin_end_types_enabled;
// The min and max size (both length and width, in dips) of the generated
// bounding box for all gesture types. This is useful for touch streams
// that may report zero or unreasonably small or large touch sizes.
// Note that these bounds are only applied for touch or unknown tool types;
// mouse and stylus-derived gestures will not be affected.
// Both values default to 0 (disabled).
float min_gesture_bounds_length;
float max_gesture_bounds_length;
};
GestureProvider(const Config& config, GestureProviderClient* client);
~GestureProvider();
// Handle the incoming MotionEvent, returning false if the event could not
// be handled.
bool OnTouchEvent(const MotionEvent& event);
// Reset any active gesture detection, including detection of timeout-based
// events (e.g., double-tap or delayed tap) for which the pointer has already
// been released.
void ResetDetection();
// Update whether multi-touch pinch zoom is supported by the platform.
void SetMultiTouchZoomSupportEnabled(bool enabled);
// Update whether double-tap gestures are supported by the platform.
void SetDoubleTapSupportForPlatformEnabled(bool enabled);
// Update whether double-tap gesture detection should be suppressed, e.g.,
// if the page scale is fixed or the page has a mobile viewport. This disables
// the tap delay, allowing rapid and responsive single-tap gestures.
void SetDoubleTapSupportForPageEnabled(bool enabled);
// Whether a scroll gesture is in-progress.
bool IsScrollInProgress() const;
// Whether a pinch gesture is in-progress (i.e. a pinch update has been
// forwarded and detection is still active).
bool IsPinchInProgress() const;
// Whether a double-tap gesture is in-progress (either double-tap or
// double-tap drag zoom).
bool IsDoubleTapInProgress() const;
// May be NULL if there is no currently active touch sequence.
const ui::MotionEvent* current_down_event() const {
return current_down_event_.get();
}
private:
bool CanHandle(const MotionEvent& event) const;
void OnTouchEventHandlingBegin(const MotionEvent& event);
void OnTouchEventHandlingEnd(const MotionEvent& event);
void UpdateDoubleTapDetectionSupport();
class GestureListenerImpl;
scoped_ptr<GestureListenerImpl> gesture_listener_;
scoped_ptr<MotionEvent> current_down_event_;
// Logs information on touch and gesture events.
GestureTouchUMAHistogram uma_histogram_;
// Whether double-tap gesture detection is currently supported.
bool double_tap_support_for_page_;
bool double_tap_support_for_platform_;
const bool gesture_begin_end_types_enabled_;
};
} // namespace ui
#endif // UI_EVENTS_GESTURE_DETECTION_GESTURE_PROVIDER_H_
|
