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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
|
// 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_AURA_WINDOW_EVENT_DISPATCHER_H_
#define UI_AURA_WINDOW_EVENT_DISPATCHER_H_
#include <stdint.h>
#include <vector>
#include "base/gtest_prod_util.h"
#include "base/macros.h"
#include "base/memory/ref_counted.h"
#include "base/memory/scoped_ptr.h"
#include "base/memory/weak_ptr.h"
#include "base/message_loop/message_loop.h"
#include "base/scoped_observer.h"
#include "ui/aura/aura_export.h"
#include "ui/aura/client/capture_delegate.h"
#include "ui/aura/env_observer.h"
#include "ui/aura/window_observer.h"
#include "ui/base/cursor/cursor.h"
#include "ui/events/event_constants.h"
#include "ui/events/event_processor.h"
#include "ui/events/event_targeter.h"
#include "ui/events/gestures/gesture_recognizer.h"
#include "ui/events/gestures/gesture_types.h"
#include "ui/gfx/geometry/point.h"
#include "ui/gfx/native_widget_types.h"
namespace gfx {
class Size;
class Transform;
}
namespace ui {
class GestureEvent;
class GestureRecognizer;
class KeyEvent;
class MouseEvent;
class ScrollEvent;
class TouchEvent;
}
namespace aura {
class TestScreen;
class WindowTargeter;
class WindowTreeHost;
namespace test {
class WindowEventDispatcherTestApi;
}
// WindowEventDispatcher orchestrates event dispatch within a window tree
// owned by WindowTreeHost. WTH also owns the WED.
// TODO(beng): In progress, remove functionality not directly related to
// event dispatch.
class AURA_EXPORT WindowEventDispatcher : public ui::EventProcessor,
public ui::GestureEventHelper,
public client::CaptureDelegate,
public WindowObserver,
public EnvObserver {
public:
explicit WindowEventDispatcher(WindowTreeHost* host);
~WindowEventDispatcher() override;
void set_transform_events(bool value) { transform_events_ = value; }
Window* mouse_pressed_handler() { return mouse_pressed_handler_; }
Window* mouse_moved_handler() { return mouse_moved_handler_; }
// Repost event for re-processing. Used when exiting context menus.
// We support the ET_MOUSE_PRESSED, ET_TOUCH_PRESSED and ET_GESTURE_TAP_DOWN
// event types (although the latter is currently a no-op).
void RepostEvent(const ui::LocatedEvent* event);
// Invoked when the mouse events get enabled or disabled.
void OnMouseEventsEnableStateChanged(bool enabled);
void DispatchCancelModeEvent();
// Dispatches a ui::ET_MOUSE_EXITED event at |point| to the |target|
// If the |target| is NULL, we will dispatch the event to the root-window
// TODO(beng): needed only for WTH::OnCursorVisibilityChanged().
ui::EventDispatchDetails DispatchMouseExitAtPoint(Window* target,
const gfx::Point& point)
WARN_UNUSED_RESULT;
// Gesture Recognition -------------------------------------------------------
// When a touch event is dispatched to a Window, it may want to process the
// touch event asynchronously. In such cases, the window should consume the
// event during the event dispatch. Once the event is properly processed, the
// window should let the WindowEventDispatcher know about the result of the
// event processing, so that gesture events can be properly created and
// dispatched. |event|'s location should be in the dispatcher's coordinate
// space, in DIPs.
virtual void ProcessedTouchEvent(uint32_t unique_event_id,
Window* window,
ui::EventResult result);
// These methods are used to defer the processing of mouse/touch events
// related to resize. A client (typically a RenderWidgetHostViewAura) can call
// HoldPointerMoves when an resize is initiated and then ReleasePointerMoves
// once the resize is completed.
//
// More than one hold can be invoked and each hold must be cancelled by a
// release before we resume normal operation.
void HoldPointerMoves();
void ReleasePointerMoves();
// Gets the last location seen in a mouse event in this root window's
// coordinates. This may return a point outside the root window's bounds.
gfx::Point GetLastMouseLocationInRoot() const;
void OnHostLostMouseGrab();
void OnCursorMovedToRootLocation(const gfx::Point& root_location);
// TODO(beng): This is only needed because this cleanup needs to happen after
// all other observers are notified of OnWindowDestroying() but
// before OnWindowDestroyed() is sent (i.e. while the window
// hierarchy is still intact). This didn't seem worth adding a
// generic notification for as only this class needs to implement
// it. I would however like to find a way to do this via an
// observer.
void OnPostNotifiedWindowDestroying(Window* window);
private:
FRIEND_TEST_ALL_PREFIXES(WindowEventDispatcherTest,
KeepTranslatedEventInRoot);
friend class test::WindowEventDispatcherTestApi;
friend class Window;
friend class TestScreen;
// The parameter for OnWindowHidden() to specify why window is hidden.
enum WindowHiddenReason {
WINDOW_DESTROYED, // Window is destroyed.
WINDOW_HIDDEN, // Window is hidden.
WINDOW_MOVING, // Window is temporarily marked as hidden due to move
// across root windows.
};
Window* window();
const Window* window() const;
// Updates the event with the appropriate transform for the device scale
// factor. The WindowEventDispatcher dispatches events in the physical pixel
// coordinate. But the event processing from WindowEventDispatcher onwards
// happen in device-independent pixel coordinate. So it is necessary to update
// the event received from the host.
void TransformEventForDeviceScaleFactor(ui::LocatedEvent* event);
// Dispatches OnMouseExited to the |window| which is hiding if necessary.
void DispatchMouseExitToHidingWindow(Window* window);
// Dispatches the specified event type (intended for enter/exit) to the
// |mouse_moved_handler_|.
// The event's location will be converted from |target|coordinate system to
// |mouse_moved_handler_| coordinate system.
ui::EventDispatchDetails DispatchMouseEnterOrExit(Window* target,
const ui::MouseEvent& event,
ui::EventType type)
WARN_UNUSED_RESULT;
ui::EventDispatchDetails ProcessGestures(
Window* target,
ui::GestureRecognizer::Gestures* gestures) WARN_UNUSED_RESULT;
// Called when a window becomes invisible, either by being removed
// from root window hierarchy, via SetVisible(false) or being destroyed.
// |reason| specifies what triggered the hiding. Note that becoming invisible
// will cause a window to lose capture and some windows may destroy themselves
// on capture (like DragDropTracker).
void OnWindowHidden(Window* invisible, WindowHiddenReason reason);
bool is_dispatched_held_event(const ui::Event& event) const;
// Overridden from aura::client::CaptureDelegate:
void UpdateCapture(Window* old_capture, Window* new_capture) override;
void OnOtherRootGotCapture() override;
void SetNativeCapture() override;
void ReleaseNativeCapture() override;
// Overridden from ui::EventProcessor:
ui::EventTarget* GetRootTarget() override;
void OnEventProcessingStarted(ui::Event* event) override;
// Overridden from ui::EventDispatcherDelegate.
bool CanDispatchToTarget(ui::EventTarget* target) override;
ui::EventDispatchDetails PreDispatchEvent(ui::EventTarget* target,
ui::Event* event) override;
ui::EventDispatchDetails PostDispatchEvent(ui::EventTarget* target,
const ui::Event& event) override;
// Overridden from ui::GestureEventHelper.
bool CanDispatchToConsumer(ui::GestureConsumer* consumer) override;
void DispatchGestureEvent(ui::GestureConsumer* raw_input_consumer,
ui::GestureEvent* event) override;
void DispatchCancelTouchEvent(ui::GestureConsumer* raw_input_consumer,
ui::TouchEvent* event) override;
// Overridden from WindowObserver:
void OnWindowDestroying(Window* window) override;
void OnWindowDestroyed(Window* window) override;
void OnWindowAddedToRootWindow(Window* window) override;
void OnWindowRemovingFromRootWindow(Window* window,
Window* new_root) override;
void OnWindowVisibilityChanging(Window* window, bool visible) override;
void OnWindowVisibilityChanged(Window* window, bool visible) override;
void OnWindowBoundsChanged(Window* window,
const gfx::Rect& old_bounds,
const gfx::Rect& new_bounds) override;
void OnWindowTransforming(Window* window) override;
void OnWindowTransformed(Window* window) override;
// Overridden from EnvObserver:
void OnWindowInitialized(Window* window) override;
// We hold and aggregate mouse drags and touch moves as a way of throttling
// resizes when HoldMouseMoves() is called. The following methods are used to
// dispatch held and newly incoming mouse and touch events, typically when an
// event other than one of these needs dispatching or a matching
// ReleaseMouseMoves()/ReleaseTouchMoves() is called. NOTE: because these
// methods dispatch events from WindowTreeHost the coordinates are in terms of
// the root.
ui::EventDispatchDetails DispatchHeldEvents() WARN_UNUSED_RESULT;
// Posts a task to send synthesized mouse move event if there is no a pending
// task.
void PostSynthesizeMouseMove();
// Creates and dispatches synthesized mouse move event using the current mouse
// location.
ui::EventDispatchDetails SynthesizeMouseMoveEvent() WARN_UNUSED_RESULT;
// Calls SynthesizeMouseMove() if |window| is currently visible and contains
// the mouse cursor.
void SynthesizeMouseMoveAfterChangeToWindow(Window* window);
ui::EventDispatchDetails PreDispatchLocatedEvent(Window* target,
ui::LocatedEvent* event);
ui::EventDispatchDetails PreDispatchMouseEvent(Window* target,
ui::MouseEvent* event);
ui::EventDispatchDetails PreDispatchTouchEvent(Window* target,
ui::TouchEvent* event);
WindowTreeHost* host_;
// Touch ids that are currently down.
uint32_t touch_ids_down_;
Window* mouse_pressed_handler_;
Window* mouse_moved_handler_;
Window* event_dispatch_target_;
Window* old_dispatch_target_;
bool synthesize_mouse_move_;
// How many move holds are outstanding. We try to defer dispatching
// touch/mouse moves while the count is > 0.
int move_hold_count_;
// The location of |held_move_event_| is in |window_|'s coordinate.
scoped_ptr<ui::LocatedEvent> held_move_event_;
// Allowing for reposting of events. Used when exiting context menus.
scoped_ptr<ui::LocatedEvent> held_repostable_event_;
// Set when dispatching a held event.
ui::LocatedEvent* dispatching_held_event_;
ScopedObserver<aura::Window, aura::WindowObserver> observer_manager_;
bool transform_events_;
// Used to schedule reposting an event.
base::WeakPtrFactory<WindowEventDispatcher> repost_event_factory_;
// Used to schedule DispatchHeldEvents() when |move_hold_count_| goes to 0.
base::WeakPtrFactory<WindowEventDispatcher> held_event_factory_;
DISALLOW_COPY_AND_ASSIGN(WindowEventDispatcher);
};
} // namespace aura
#endif // UI_AURA_WINDOW_EVENT_DISPATCHER_H_
|