Stop hit testing culled inlines when a match is found

third_party/WebKit/Source/core/layout/HitTestResult.h

 /*
  * Copyright (C) 2006 Apple Computer, Inc.
  * Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies)
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
  * License as published by the Free Software Foundation; either
  * version 2 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
@@ skipping 10 matching lines @@
 
 #ifndef HitTestResult_h
 #define HitTestResult_h
 
 #include "core/CoreExport.h"
 #include "core/editing/PositionWithAffinity.h"
 #include "core/layout/HitTestLocation.h"
 #include "core/layout/HitTestRequest.h"
 #include "platform/geometry/FloatQuad.h"
 #include "platform/geometry/FloatRect.h"
-#include "platform/geometry/LayoutRect.h"
 #include "platform/heap/Handle.h"
 #include "platform/text/TextDirection.h"
 #include "wtf/Forward.h"
 #include "wtf/ListHashSet.h"
 #include "wtf/OwnPtr.h"
 #include "wtf/RefPtr.h"
 #include "wtf/VectorTraits.h"
 
 namespace blink {
 
 class Element;
 class LocalFrame;
 class HTMLAreaElement;
 class HTMLMediaElement;
 class Image;
 class KURL;
 class Node;
 class LayoutObject;
+class Region;
 class Scrollbar;
 
+// List-based hit test testing can continue even after a hit has been found.
+// This is used to support fuzzy matching with rect-based hit tests as well as
+// penetrating tests which collect all nodes (see: HitTestRequest::RequestType).
+enum ListBasedHitTestBehavior {
+    ContinueHitTesting,
+    StopHitTesting
+};
+
 class CORE_EXPORT HitTestResult {
     DISALLOW_NEW_EXCEPT_PLACEMENT_NEW();
-
 public:
     typedef WillBeHeapListHashSet<RefPtrWillBeMember<Node>> NodeSet;
 
     HitTestResult();
     HitTestResult(const HitTestRequest&, const LayoutPoint&);
     // Pass positive padding values to perform a rect-based hit test.
     HitTestResult(const HitTestRequest&, const LayoutPoint& centerPoint, unsigned topPadding, unsigned rightPadding, unsigned bottomPadding, unsigned leftPadding);
     HitTestResult(const HitTestRequest&, const HitTestLocation&);
     HitTestResult(const HitTestResult&);
     ~HitTestResult();
@@ skipping 65 matching lines @@
     String textContent() const;
     bool isLiveLink() const;
     bool isMisspelled() const;
     bool isContentEditable() const;
 
     bool isOverLink() const;
 
     bool isCacheable() const { return m_cacheable; }
     void setCacheable(bool cacheable) { m_cacheable = cacheable; }
 
-    // Return true if the test is a list-based test and we should continue testing.
-    bool addNodeToListBasedTestResult(Node*, const HitTestLocation& pointInContainer, const LayoutRect& = LayoutRect());
+    // TODO(pdr): When using the default rect argument, this function does not
+    // check if the tapped area is entirely contained by the HitTestLocation's
+    // bounding box. Callers should pass a LayoutRect as the third parameter so
+    // hit testing can early-out when a tapped area is covered.
+    ListBasedHitTestBehavior addNodeToListBasedTestResult(Node*, const HitTestLocation&, const LayoutRect& = LayoutRect());
+    ListBasedHitTestBehavior addNodeToListBasedTestResult(Node*, const HitTestLocation&, const Region&);
+
     void append(const HitTestResult&);
 
     // If m_listBasedTestResult is 0 then set it to a new NodeSet. Return *m_listBasedTestResult. Lazy allocation makes
     // sense because the NodeSet is seldom necessary, and it's somewhat expensive to allocate and initialize. This method does
     // the same thing as mutableListBasedTestResult(), but here the return value is const.
     const NodeSet& listBasedTestResult() const;
 
     // Collapse the rect-based test result into a single target at the specified location.
     void resolveRectBasedTest(Node* resolvedInnerNode, const LayoutPoint& resolvedPointInMainFrame);
 
@@ skipping 16 matching lines @@
     bool m_isOverWidget; // Returns true if we are over a widget (and not in the border/padding area of a LayoutPart for example).
 
     mutable OwnPtrWillBeMember<NodeSet> m_listBasedTestResult;
 };
 
 } // namespace blink
 
 WTF_ALLOW_CLEAR_UNUSED_SLOTS_WITH_MEM_FUNCTIONS(blink::HitTestResult);
 
 #endif // HitTestResult_h