event_dispatcher.cc revision a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7
15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved.
25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be
35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file.
45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
5d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles)#include "ui/events/event_dispatcher.h"
65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
72a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include <algorithm>
82a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
9a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)#include "ui/events/event_target.h"
10a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)#include "ui/events/event_targeter.h"
11a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)
125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace ui {
135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)namespace {
152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1668043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles)class ScopedDispatchHelper : public Event::DispatcherApi {
172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) public:
182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  explicit ScopedDispatchHelper(Event* event)
192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      : Event::DispatcherApi(event) {
202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    set_result(ui::ER_UNHANDLED);
212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  virtual ~ScopedDispatchHelper() {
242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    set_phase(EP_POSTDISPATCH);
252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) private:
282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  DISALLOW_COPY_AND_ASSIGN(ScopedDispatchHelper);
292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)};
302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}  // namespace
322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)EventDispatcherDelegate::EventDispatcherDelegate()
342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    : dispatcher_(NULL) {
355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
372a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)EventDispatcherDelegate::~EventDispatcherDelegate() {
382a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (dispatcher_)
392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    dispatcher_->OnDispatcherDelegateDestroyed();
405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)Event* EventDispatcherDelegate::current_event() {
432a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  return dispatcher_ ? dispatcher_->current_event() : NULL;
442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}
452a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
46f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)EventDispatchDetails EventDispatcherDelegate::DispatchEvent(EventTarget* target,
47f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)                                                            Event* event) {
48a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)  CHECK(target);
49a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)  EventDispatchDetails details = PreDispatchEvent(target, event);
50a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)  if (!details.dispatcher_destroyed)
51a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)    details = DispatchEventToTarget(target, event);
52a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)  if (!details.dispatcher_destroyed)
53a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)    details = PostDispatchEvent(target, *event);
54a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)
55a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)  return details;
56a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)}
57a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)
58a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)EventDispatchDetails EventDispatcherDelegate::PreDispatchEvent(
59a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)    EventTarget* target, Event* event) {
60a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)  return EventDispatchDetails();
61a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)}
62a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)
63a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)EventDispatchDetails EventDispatcherDelegate::PostDispatchEvent(
64a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)    EventTarget* target, const Event& event) {
65a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)  return EventDispatchDetails();
66a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)}
67a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)
68a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)EventDispatchDetails EventDispatcherDelegate::DispatchEventToTarget(
69a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)    EventTarget* target,
70a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)    Event* event) {
712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  EventDispatcher* old_dispatcher = dispatcher_;
722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  EventDispatcher dispatcher(this);
732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatcher_ = &dispatcher;
742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatcher.ProcessEvent(target, event);
752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (!dispatcher.delegate_destroyed())
762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    dispatcher_ = old_dispatcher;
772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  else if (old_dispatcher)
782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    old_dispatcher->OnDispatcherDelegateDestroyed();
792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
80f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  return dispatcher.details();
812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}
825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
83a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)////////////////////////////////////////////////////////////////////////////////
84a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)// EventDispatcher:
85a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)
862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)EventDispatcher::EventDispatcher(EventDispatcherDelegate* delegate)
872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    : delegate_(delegate),
882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      current_event_(NULL) {
895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)EventDispatcher::~EventDispatcher() {
925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void EventDispatcher::OnHandlerDestroyed(EventHandler* handler) {
952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  handler_list_.erase(std::find(handler_list_.begin(),
962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)                                handler_list_.end(),
972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)                                handler));
985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void EventDispatcher::ProcessEvent(EventTarget* target, Event* event) {
1012a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (!target || !target->CanAcceptEvent(*event))
1022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    return;
1032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  ScopedDispatchHelper dispatch_helper(event);
1052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatch_helper.set_target(target);
1062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  handler_list_.clear();
1082a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  target->GetPreTargetHandlers(&handler_list_);
1092a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatch_helper.set_phase(EP_PRETARGET);
1111e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)  DispatchEventToEventHandlers(&handler_list_, event);
1122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (event->handled())
1132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    return;
1142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // If the event hasn't been consumed, trigger the default handler. Note that
1162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // even if the event has already been handled (i.e. return result has
1172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // ER_HANDLED set), that means that the event should still be processed at
1182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // this layer, however it should not be processed in the next layer of
1192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // abstraction.
1202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (delegate_ && delegate_->CanDispatchToTarget(target)) {
1212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    dispatch_helper.set_phase(EP_TARGET);
1222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    DispatchEvent(target, event);
1232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    if (event->handled())
1242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      return;
1252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
1262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
127f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  if (!delegate_)
1282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    return;
1292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
130f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  if (!delegate_->CanDispatchToTarget(target)) {
131f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)    details_.target_destroyed = true;
132f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)    return;
133f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  }
134f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)
1352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  handler_list_.clear();
1362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  target->GetPostTargetHandlers(&handler_list_);
1372a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatch_helper.set_phase(EP_POSTTARGET);
1381e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)  DispatchEventToEventHandlers(&handler_list_, event);
1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void EventDispatcher::OnDispatcherDelegateDestroyed() {
142f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  details_.dispatcher_destroyed = true;
1432a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  delegate_ = NULL;
1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)////////////////////////////////////////////////////////////////////////////////
1472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// EventDispatcher, private:
1482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1491e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)void EventDispatcher::DispatchEventToEventHandlers(EventHandlerList* list,
1502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)                                                   Event* event) {
1511e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)  for (EventHandlerList::const_iterator it = list->begin(),
1521e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)           end = list->end(); it != end; ++it) {
1532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    (*it)->dispatchers_.push(this);
1542a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
1552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1561e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)  while (!list->empty()) {
1571e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)    EventHandler* handler = (*list->begin());
1582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    if (delegate_ && !event->stopped_propagation())
1592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      DispatchEvent(handler, event);
1602a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1611e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)    if (!list->empty() && *list->begin() == handler) {
1622a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      // The handler has not been destroyed (because if it were, then it would
1632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      // have been removed from the list).
1642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      CHECK(handler->dispatchers_.top() == this);
1652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      handler->dispatchers_.pop();
1661e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)      list->erase(list->begin());
1672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    }
1682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
1692a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}
1702a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void EventDispatcher::DispatchEvent(EventHandler* handler, Event* event) {
1722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // If the target has been invalidated or deleted, don't dispatch the event.
1732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (!delegate_->CanDispatchToTarget(event->target())) {
174f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)    details_.target_destroyed = true;
175c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)    if (event->cancelable())
176c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)      event->StopPropagation();
1772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    return;
1782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  base::AutoReset<Event*> event_reset(&current_event_, event);
1812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  handler->OnEvent(event);
182c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)  if (!delegate_ && event->cancelable())
183c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)    event->StopPropagation();
1845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
1855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}  // namespace ui
187