event_dispatcher.cc revision f2477e01787aa58f445919b809d89e252beef54f
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)
95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace ui {
105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)namespace {
122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1368043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles)class ScopedDispatchHelper : public Event::DispatcherApi {
142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) public:
152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  explicit ScopedDispatchHelper(Event* event)
162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      : Event::DispatcherApi(event) {
172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    set_result(ui::ER_UNHANDLED);
182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  virtual ~ScopedDispatchHelper() {
212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    set_phase(EP_POSTDISPATCH);
222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) private:
252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  DISALLOW_COPY_AND_ASSIGN(ScopedDispatchHelper);
262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)};
272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}  // namespace
292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)EventDispatcherDelegate::EventDispatcherDelegate()
312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    : dispatcher_(NULL) {
325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)EventDispatcherDelegate::~EventDispatcherDelegate() {
352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (dispatcher_)
362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    dispatcher_->OnDispatcherDelegateDestroyed();
375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)Event* EventDispatcherDelegate::current_event() {
402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  return dispatcher_ ? dispatcher_->current_event() : NULL;
412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}
422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
43f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)EventDispatchDetails EventDispatcherDelegate::DispatchEvent(EventTarget* target,
44f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)                                                            Event* event) {
452a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  EventDispatcher* old_dispatcher = dispatcher_;
462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  EventDispatcher dispatcher(this);
472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatcher_ = &dispatcher;
482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatcher.ProcessEvent(target, event);
492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (!dispatcher.delegate_destroyed())
502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    dispatcher_ = old_dispatcher;
512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  else if (old_dispatcher)
522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    old_dispatcher->OnDispatcherDelegateDestroyed();
532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
54f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  return dispatcher.details();
552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}
565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
572a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)EventDispatcher::EventDispatcher(EventDispatcherDelegate* delegate)
582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    : delegate_(delegate),
592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      current_event_(NULL) {
605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
622a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)EventDispatcher::~EventDispatcher() {
635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void EventDispatcher::OnHandlerDestroyed(EventHandler* handler) {
662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  handler_list_.erase(std::find(handler_list_.begin(),
672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)                                handler_list_.end(),
682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)                                handler));
695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void EventDispatcher::ProcessEvent(EventTarget* target, Event* event) {
722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (!target || !target->CanAcceptEvent(*event))
732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    return;
742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  ScopedDispatchHelper dispatch_helper(event);
762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatch_helper.set_target(target);
772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  handler_list_.clear();
792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  target->GetPreTargetHandlers(&handler_list_);
802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatch_helper.set_phase(EP_PRETARGET);
821e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)  DispatchEventToEventHandlers(&handler_list_, event);
832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (event->handled())
842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    return;
852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // If the event hasn't been consumed, trigger the default handler. Note that
872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // even if the event has already been handled (i.e. return result has
882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // ER_HANDLED set), that means that the event should still be processed at
892a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // this layer, however it should not be processed in the next layer of
902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // abstraction.
912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (delegate_ && delegate_->CanDispatchToTarget(target)) {
922a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    dispatch_helper.set_phase(EP_TARGET);
932a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    DispatchEvent(target, event);
942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    if (event->handled())
952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      return;
962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
98f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  if (!delegate_)
992a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    return;
1002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
101f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  if (!delegate_->CanDispatchToTarget(target)) {
102f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)    details_.target_destroyed = true;
103f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)    return;
104f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  }
105f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)
1062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  handler_list_.clear();
1072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  target->GetPostTargetHandlers(&handler_list_);
1082a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  dispatch_helper.set_phase(EP_POSTTARGET);
1091e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)  DispatchEventToEventHandlers(&handler_list_, event);
1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void EventDispatcher::OnDispatcherDelegateDestroyed() {
113f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)  details_.dispatcher_destroyed = true;
1142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  delegate_ = NULL;
1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)////////////////////////////////////////////////////////////////////////////////
1182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// EventDispatcher, private:
1192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1201e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)void EventDispatcher::DispatchEventToEventHandlers(EventHandlerList* list,
1212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)                                                   Event* event) {
1221e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)  for (EventHandlerList::const_iterator it = list->begin(),
1231e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)           end = list->end(); it != end; ++it) {
1242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    (*it)->dispatchers_.push(this);
1252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
1262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1271e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)  while (!list->empty()) {
1281e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)    EventHandler* handler = (*list->begin());
1292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    if (delegate_ && !event->stopped_propagation())
1302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      DispatchEvent(handler, event);
1312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1321e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)    if (!list->empty() && *list->begin() == handler) {
1332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      // The handler has not been destroyed (because if it were, then it would
1342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      // have been removed from the list).
1352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      CHECK(handler->dispatchers_.top() == this);
1362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)      handler->dispatchers_.pop();
1371e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)      list->erase(list->begin());
1382a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    }
1392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
1402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}
1412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
1422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void EventDispatcher::DispatchEvent(EventHandler* handler, Event* event) {
1432a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  // If the target has been invalidated or deleted, don't dispatch the event.
1442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  if (!delegate_->CanDispatchToTarget(event->target())) {
145f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)    details_.target_destroyed = true;
146c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)    if (event->cancelable())
147c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)      event->StopPropagation();
1482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    return;
1492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  }
1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  base::AutoReset<Event*> event_reset(&current_event_, event);
1522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)  handler->OnEvent(event);
153c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)  if (!delegate_ && event->cancelable())
154c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)    event->StopPropagation();
1555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}
1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}  // namespace ui
158