// Copyright (c) 2013 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. #include <vector> #include "testing/gtest/include/gtest/gtest.h" #include "ui/events/event.h" #include "ui/events/event_targeter.h" #include "ui/events/test/events_test_utils.h" #include "ui/events/test/test_event_handler.h" #include "ui/events/test/test_event_processor.h" #include "ui/events/test/test_event_target.h" typedef std::vector<std::string> HandlerSequenceRecorder; namespace ui { namespace test { class EventProcessorTest : public testing::Test { public: EventProcessorTest() {} virtual ~EventProcessorTest() {} // testing::Test: virtual void SetUp() OVERRIDE { processor_.SetRoot(scoped_ptr<EventTarget>(new TestEventTarget())); root()->SetEventTargeter(make_scoped_ptr(new EventTargeter())); } TestEventTarget* root() { return static_cast<TestEventTarget*>(processor_.GetRootTarget()); } void DispatchEvent(Event* event) { processor_.OnEventFromSource(event); } protected: TestEventProcessor processor_; DISALLOW_COPY_AND_ASSIGN(EventProcessorTest); }; TEST_F(EventProcessorTest, Basic) { scoped_ptr<TestEventTarget> child(new TestEventTarget()); root()->AddChild(child.Pass()); MouseEvent mouse(ET_MOUSE_MOVED, gfx::Point(10, 10), gfx::Point(10, 10), EF_NONE, EF_NONE); DispatchEvent(&mouse); EXPECT_TRUE(root()->child_at(0)->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_FALSE(root()->DidReceiveEvent(ET_MOUSE_MOVED)); root()->RemoveChild(root()->child_at(0)); DispatchEvent(&mouse); EXPECT_TRUE(root()->DidReceiveEvent(ET_MOUSE_MOVED)); } template<typename T> class BoundsEventTargeter : public EventTargeter { public: virtual ~BoundsEventTargeter() {} protected: virtual bool SubtreeShouldBeExploredForEvent( EventTarget* target, const LocatedEvent& event) OVERRIDE { T* t = static_cast<T*>(target); return (t->bounds().Contains(event.location())); } }; class BoundsTestTarget : public TestEventTarget { public: BoundsTestTarget() {} virtual ~BoundsTestTarget() {} void set_bounds(gfx::Rect rect) { bounds_ = rect; } gfx::Rect bounds() const { return bounds_; } static void ConvertPointToTarget(BoundsTestTarget* source, BoundsTestTarget* target, gfx::Point* location) { gfx::Vector2d vector; if (source->Contains(target)) { for (; target && target != source; target = static_cast<BoundsTestTarget*>(target->parent())) { vector += target->bounds().OffsetFromOrigin(); } *location -= vector; } else if (target->Contains(source)) { for (; source && source != target; source = static_cast<BoundsTestTarget*>(source->parent())) { vector += source->bounds().OffsetFromOrigin(); } *location += vector; } else { NOTREACHED(); } } private: // EventTarget: virtual void ConvertEventToTarget(EventTarget* target, LocatedEvent* event) OVERRIDE { event->ConvertLocationToTarget(this, static_cast<BoundsTestTarget*>(target)); } gfx::Rect bounds_; DISALLOW_COPY_AND_ASSIGN(BoundsTestTarget); }; TEST_F(EventProcessorTest, Bounds) { scoped_ptr<BoundsTestTarget> parent(new BoundsTestTarget()); scoped_ptr<BoundsTestTarget> child(new BoundsTestTarget()); scoped_ptr<BoundsTestTarget> grandchild(new BoundsTestTarget()); parent->set_bounds(gfx::Rect(0, 0, 30, 30)); child->set_bounds(gfx::Rect(5, 5, 20, 20)); grandchild->set_bounds(gfx::Rect(5, 5, 5, 5)); child->AddChild(scoped_ptr<TestEventTarget>(grandchild.Pass())); parent->AddChild(scoped_ptr<TestEventTarget>(child.Pass())); root()->AddChild(scoped_ptr<TestEventTarget>(parent.Pass())); ASSERT_EQ(1u, root()->child_count()); ASSERT_EQ(1u, root()->child_at(0)->child_count()); ASSERT_EQ(1u, root()->child_at(0)->child_at(0)->child_count()); TestEventTarget* parent_r = root()->child_at(0); TestEventTarget* child_r = parent_r->child_at(0); TestEventTarget* grandchild_r = child_r->child_at(0); // Dispatch a mouse event that falls on the parent, but not on the child. When // the default event-targeter used, the event will still reach |grandchild|, // because the default targeter does not look at the bounds. MouseEvent mouse(ET_MOUSE_MOVED, gfx::Point(1, 1), gfx::Point(1, 1), EF_NONE, EF_NONE); DispatchEvent(&mouse); EXPECT_FALSE(root()->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_FALSE(parent_r->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_FALSE(child_r->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_TRUE(grandchild_r->DidReceiveEvent(ET_MOUSE_MOVED)); grandchild_r->ResetReceivedEvents(); // Now install a targeter on the parent that looks at the bounds and makes // sure the event reaches the target only if the location of the event within // the bounds of the target. MouseEvent mouse2(ET_MOUSE_MOVED, gfx::Point(1, 1), gfx::Point(1, 1), EF_NONE, EF_NONE); parent_r->SetEventTargeter(scoped_ptr<EventTargeter>( new BoundsEventTargeter<BoundsTestTarget>())); DispatchEvent(&mouse2); EXPECT_FALSE(root()->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_TRUE(parent_r->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_FALSE(child_r->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_FALSE(grandchild_r->DidReceiveEvent(ET_MOUSE_MOVED)); parent_r->ResetReceivedEvents(); MouseEvent second(ET_MOUSE_MOVED, gfx::Point(12, 12), gfx::Point(12, 12), EF_NONE, EF_NONE); DispatchEvent(&second); EXPECT_FALSE(root()->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_FALSE(parent_r->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_FALSE(child_r->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_TRUE(grandchild_r->DidReceiveEvent(ET_MOUSE_MOVED)); } class IgnoreEventTargeter : public EventTargeter { public: IgnoreEventTargeter() {} virtual ~IgnoreEventTargeter() {} private: // EventTargeter: virtual bool SubtreeShouldBeExploredForEvent( EventTarget* target, const LocatedEvent& event) OVERRIDE { return false; } }; // Verifies that the EventTargeter installed on an EventTarget can dictate // whether the target itself can process an event. TEST_F(EventProcessorTest, TargeterChecksOwningEventTarget) { scoped_ptr<TestEventTarget> child(new TestEventTarget()); root()->AddChild(child.Pass()); MouseEvent mouse(ET_MOUSE_MOVED, gfx::Point(10, 10), gfx::Point(10, 10), EF_NONE, EF_NONE); DispatchEvent(&mouse); EXPECT_TRUE(root()->child_at(0)->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_FALSE(root()->DidReceiveEvent(ET_MOUSE_MOVED)); root()->child_at(0)->ResetReceivedEvents(); // Install an event handler on |child| which always prevents the target from // receiving event. root()->child_at(0)->SetEventTargeter( scoped_ptr<EventTargeter>(new IgnoreEventTargeter())); MouseEvent mouse2(ET_MOUSE_MOVED, gfx::Point(10, 10), gfx::Point(10, 10), EF_NONE, EF_NONE); DispatchEvent(&mouse2); EXPECT_FALSE(root()->child_at(0)->DidReceiveEvent(ET_MOUSE_MOVED)); EXPECT_TRUE(root()->DidReceiveEvent(ET_MOUSE_MOVED)); } // An EventTargeter which is used to allow a bubbling behaviour in event // dispatch: if an event is not handled after being dispatched to its // initial target, the event is dispatched to the next-best target as // specified by FindNextBestTarget(). class BubblingEventTargeter : public EventTargeter { public: explicit BubblingEventTargeter(TestEventTarget* initial_target) : initial_target_(initial_target) {} virtual ~BubblingEventTargeter() {} private: // EventTargeter: virtual EventTarget* FindTargetForEvent(EventTarget* root, Event* event) OVERRIDE { return initial_target_; } virtual EventTarget* FindNextBestTarget(EventTarget* previous_target, Event* event) OVERRIDE { return previous_target->GetParentTarget(); } TestEventTarget* initial_target_; DISALLOW_COPY_AND_ASSIGN(BubblingEventTargeter); }; // Tests that unhandled events are correctly dispatched to the next-best // target as decided by the BubblingEventTargeter. TEST_F(EventProcessorTest, DispatchToNextBestTarget) { scoped_ptr<TestEventTarget> child(new TestEventTarget()); scoped_ptr<TestEventTarget> grandchild(new TestEventTarget()); root()->SetEventTargeter( scoped_ptr<EventTargeter>(new BubblingEventTargeter(grandchild.get()))); child->AddChild(grandchild.Pass()); root()->AddChild(child.Pass()); ASSERT_EQ(1u, root()->child_count()); ASSERT_EQ(1u, root()->child_at(0)->child_count()); ASSERT_EQ(0u, root()->child_at(0)->child_at(0)->child_count()); TestEventTarget* child_r = root()->child_at(0); TestEventTarget* grandchild_r = child_r->child_at(0); // When the root has a BubblingEventTargeter installed, events targeted // at the grandchild target should be dispatched to all three targets. KeyEvent key_event(ET_KEY_PRESSED, VKEY_ESCAPE, 0, false); DispatchEvent(&key_event); EXPECT_TRUE(root()->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_TRUE(child_r->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_TRUE(grandchild_r->DidReceiveEvent(ET_KEY_PRESSED)); root()->ResetReceivedEvents(); child_r->ResetReceivedEvents(); grandchild_r->ResetReceivedEvents(); // Add a pre-target handler on the child of the root that will mark the event // as handled. No targets in the hierarchy should receive the event. TestEventHandler handler; child_r->AddPreTargetHandler(&handler); key_event = KeyEvent(ET_KEY_PRESSED, VKEY_ESCAPE, 0, false); DispatchEvent(&key_event); EXPECT_FALSE(root()->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_FALSE(child_r->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_FALSE(grandchild_r->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_EQ(1, handler.num_key_events()); handler.Reset(); // Add a post-target handler on the child of the root that will mark the event // as handled. Only the grandchild (the initial target) should receive the // event. child_r->RemovePreTargetHandler(&handler); child_r->AddPostTargetHandler(&handler); key_event = KeyEvent(ET_KEY_PRESSED, VKEY_ESCAPE, 0, false); DispatchEvent(&key_event); EXPECT_FALSE(root()->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_FALSE(child_r->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_TRUE(grandchild_r->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_EQ(1, handler.num_key_events()); handler.Reset(); grandchild_r->ResetReceivedEvents(); child_r->RemovePostTargetHandler(&handler); // Mark the event as handled when it reaches the EP_TARGET phase of // dispatch at the child of the root. The child and grandchild // targets should both receive the event, but the root should not. child_r->set_mark_events_as_handled(true); key_event = KeyEvent(ET_KEY_PRESSED, VKEY_ESCAPE, 0, false); DispatchEvent(&key_event); EXPECT_FALSE(root()->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_TRUE(child_r->DidReceiveEvent(ET_KEY_PRESSED)); EXPECT_TRUE(grandchild_r->DidReceiveEvent(ET_KEY_PRESSED)); root()->ResetReceivedEvents(); child_r->ResetReceivedEvents(); grandchild_r->ResetReceivedEvents(); child_r->set_mark_events_as_handled(false); } // Tests that unhandled events are seen by the correct sequence of // targets, pre-target handlers, and post-target handlers when // a BubblingEventTargeter is installed on the root target. TEST_F(EventProcessorTest, HandlerSequence) { scoped_ptr<TestEventTarget> child(new TestEventTarget()); scoped_ptr<TestEventTarget> grandchild(new TestEventTarget()); root()->SetEventTargeter( scoped_ptr<EventTargeter>(new BubblingEventTargeter(grandchild.get()))); child->AddChild(grandchild.Pass()); root()->AddChild(child.Pass()); ASSERT_EQ(1u, root()->child_count()); ASSERT_EQ(1u, root()->child_at(0)->child_count()); ASSERT_EQ(0u, root()->child_at(0)->child_at(0)->child_count()); TestEventTarget* child_r = root()->child_at(0); TestEventTarget* grandchild_r = child_r->child_at(0); HandlerSequenceRecorder recorder; root()->set_target_name("R"); root()->set_recorder(&recorder); child_r->set_target_name("C"); child_r->set_recorder(&recorder); grandchild_r->set_target_name("G"); grandchild_r->set_recorder(&recorder); TestEventHandler pre_root; pre_root.set_handler_name("PreR"); pre_root.set_recorder(&recorder); root()->AddPreTargetHandler(&pre_root); TestEventHandler pre_child; pre_child.set_handler_name("PreC"); pre_child.set_recorder(&recorder); child_r->AddPreTargetHandler(&pre_child); TestEventHandler pre_grandchild; pre_grandchild.set_handler_name("PreG"); pre_grandchild.set_recorder(&recorder); grandchild_r->AddPreTargetHandler(&pre_grandchild); TestEventHandler post_root; post_root.set_handler_name("PostR"); post_root.set_recorder(&recorder); root()->AddPostTargetHandler(&post_root); TestEventHandler post_child; post_child.set_handler_name("PostC"); post_child.set_recorder(&recorder); child_r->AddPostTargetHandler(&post_child); TestEventHandler post_grandchild; post_grandchild.set_handler_name("PostG"); post_grandchild.set_recorder(&recorder); grandchild_r->AddPostTargetHandler(&post_grandchild); MouseEvent mouse(ET_MOUSE_MOVED, gfx::Point(10, 10), gfx::Point(10, 10), EF_NONE, EF_NONE); DispatchEvent(&mouse); std::string expected[] = { "PreR", "PreC", "PreG", "G", "PostG", "PostC", "PostR", "PreR", "PreC", "C", "PostC", "PostR", "PreR", "R", "PostR" }; EXPECT_EQ(std::vector<std::string>( expected, expected + arraysize(expected)), recorder); } } // namespace test } // namespace ui