b0376f5d507419614ea9938f8fa0d8054ef7ae38
[WebKit-https.git] / Source / WebCore / rendering / HitTestResult.h
1 /*
2  * Copyright (C) 2006 Apple Inc.
3  * Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies)
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Library General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Library General Public License for more details.
14  *
15  * You should have received a copy of the GNU Library General Public License
16  * along with this library; see the file COPYING.LIB.  If not, write to
17  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18  * Boston, MA 02110-1301, USA.
19  *
20 */
21
22 #ifndef HitTestResult_h
23 #define HitTestResult_h
24
25 #include "FloatQuad.h"
26 #include "FloatRect.h"
27 #include "HitTestLocation.h"
28 #include "HitTestRequest.h"
29 #include "LayoutRect.h"
30 #include "TextFlags.h"
31 #include <memory>
32 #include <wtf/Forward.h>
33 #include <wtf/ListHashSet.h>
34 #include <wtf/RefPtr.h>
35
36 namespace WebCore {
37
38 class Element;
39 class Frame;
40 #if ENABLE(VIDEO)
41 class HTMLMediaElement;
42 #endif
43 class Image;
44 class URL;
45 class Node;
46 class Scrollbar;
47
48 class HitTestResult {
49 public:
50     typedef ListHashSet<RefPtr<Node>> NodeSet;
51
52     WEBCORE_EXPORT HitTestResult();
53     WEBCORE_EXPORT explicit HitTestResult(const LayoutPoint&);
54     // Pass non-negative padding values to perform a rect-based hit test.
55     WEBCORE_EXPORT HitTestResult(const LayoutPoint& centerPoint, unsigned topPadding, unsigned rightPadding, unsigned bottomPadding, unsigned leftPadding);
56     WEBCORE_EXPORT explicit HitTestResult(const HitTestLocation&);
57     WEBCORE_EXPORT HitTestResult(const HitTestResult&);
58     WEBCORE_EXPORT ~HitTestResult();
59     WEBCORE_EXPORT HitTestResult& operator=(const HitTestResult&);
60
61     Node* innerNode() const { return m_innerNode.get(); }
62     WEBCORE_EXPORT Element* innerElement() const;
63     Node* innerNonSharedNode() const { return m_innerNonSharedNode.get(); }
64     WEBCORE_EXPORT Element* innerNonSharedElement() const;
65     Element* URLElement() const { return m_innerURLElement.get(); }
66     Scrollbar* scrollbar() const { return m_scrollbar.get(); }
67     bool isOverWidget() const { return m_isOverWidget; }
68
69     WEBCORE_EXPORT const AtomicString& URLElementDownloadAttribute() const;
70
71     // Forwarded from HitTestLocation
72     bool isRectBasedTest() const { return m_hitTestLocation.isRectBasedTest(); }
73
74     // The hit-tested point in the coordinates of the main frame.
75     const LayoutPoint& pointInMainFrame() const { return m_hitTestLocation.point(); }
76     IntPoint roundedPointInMainFrame() const { return roundedIntPoint(pointInMainFrame()); }
77
78     // The hit-tested point in the coordinates of the innerNode frame, the frame containing innerNode.
79     const LayoutPoint& pointInInnerNodeFrame() const { return m_pointInInnerNodeFrame; }
80     IntPoint roundedPointInInnerNodeFrame() const { return roundedIntPoint(pointInInnerNodeFrame()); }
81     WEBCORE_EXPORT Frame* innerNodeFrame() const;
82
83     // The hit-tested point in the coordinates of the inner node.
84     const LayoutPoint& localPoint() const { return m_localPoint; }
85     void setLocalPoint(const LayoutPoint& p) { m_localPoint = p; }
86
87     void setToNonUserAgentShadowAncestor();
88
89     const HitTestLocation& hitTestLocation() const { return m_hitTestLocation; }
90
91     WEBCORE_EXPORT void setInnerNode(Node*);
92     void setInnerNonSharedNode(Node*);
93     void setURLElement(Element*);
94     void setScrollbar(Scrollbar*);
95     void setIsOverWidget(bool b) { m_isOverWidget = b; }
96
97     WEBCORE_EXPORT Frame* targetFrame() const;
98     WEBCORE_EXPORT bool isSelected() const;
99     WEBCORE_EXPORT String selectedText() const;
100     WEBCORE_EXPORT String spellingToolTip(TextDirection&) const;
101     String replacedString() const;
102     WEBCORE_EXPORT String title(TextDirection&) const;
103     String innerTextIfTruncated(TextDirection&) const;
104     WEBCORE_EXPORT String altDisplayString() const;
105     WEBCORE_EXPORT String titleDisplayString() const;
106     WEBCORE_EXPORT Image* image() const;
107     WEBCORE_EXPORT IntRect imageRect() const;
108     WEBCORE_EXPORT URL absoluteImageURL() const;
109     WEBCORE_EXPORT URL absolutePDFURL() const;
110     WEBCORE_EXPORT URL absoluteMediaURL() const;
111     WEBCORE_EXPORT URL absoluteLinkURL() const;
112 #if ENABLE(ATTACHMENT_ELEMENT)
113     WEBCORE_EXPORT URL absoluteAttachmentURL() const;
114 #endif
115     WEBCORE_EXPORT String textContent() const;
116     bool isOverLink() const;
117     WEBCORE_EXPORT bool isContentEditable() const;
118     void toggleMediaControlsDisplay() const;
119     void toggleMediaLoopPlayback() const;
120     WEBCORE_EXPORT bool mediaIsInFullscreen() const;
121     void toggleMediaFullscreenState() const;
122     void enterFullscreenForVideo() const;
123     bool mediaControlsEnabled() const;
124     bool mediaLoopEnabled() const;
125     bool mediaPlaying() const;
126     bool mediaSupportsFullscreen() const;
127     void toggleMediaPlayState() const;
128     WEBCORE_EXPORT bool mediaHasAudio() const;
129     WEBCORE_EXPORT bool mediaIsVideo() const;
130     bool mediaMuted() const;
131     void toggleMediaMuteState() const;
132     bool mediaSupportsEnhancedFullscreen() const;
133     bool mediaIsInEnhancedFullscreen() const;
134     void toggleEnhancedFullscreenForVideo() const;
135
136     WEBCORE_EXPORT bool isDownloadableMedia() const;
137     WEBCORE_EXPORT bool isOverTextInsideFormControlElement() const;
138     WEBCORE_EXPORT bool allowsCopy() const;
139
140     // Returns true if it is rect-based hit test and needs to continue until the rect is fully
141     // enclosed by the boundaries of a node.
142     bool addNodeToRectBasedTestResult(Node*, const HitTestRequest&, const HitTestLocation& pointInContainer, const LayoutRect& = LayoutRect());
143     bool addNodeToRectBasedTestResult(Node*, const HitTestRequest&, const HitTestLocation& pointInContainer, const FloatRect&);
144     void append(const HitTestResult&);
145
146     // If m_rectBasedTestResult is 0 then set it to a new NodeSet. Return *m_rectBasedTestResult. Lazy allocation makes
147     // sense because the NodeSet is seldom necessary, and it's somewhat expensive to allocate and initialize. This method does
148     // the same thing as mutableRectBasedTestResult(), but here the return value is const.
149     WEBCORE_EXPORT const NodeSet& rectBasedTestResult() const;
150
151     Vector<String> dictationAlternatives() const;
152
153     Node* targetNode() const;
154
155 private:
156     NodeSet& mutableRectBasedTestResult(); // See above.
157
158 #if ENABLE(VIDEO)
159     HTMLMediaElement* mediaElement() const;
160 #endif
161     HitTestLocation m_hitTestLocation;
162
163     RefPtr<Node> m_innerNode;
164     RefPtr<Node> m_innerNonSharedNode;
165     LayoutPoint m_pointInInnerNodeFrame; // The hit-tested point in innerNode frame coordinates.
166     LayoutPoint m_localPoint; // A point in the local coordinate space of m_innerNonSharedNode's renderer. Allows us to efficiently
167                               // determine where inside the renderer we hit on subsequent operations.
168     RefPtr<Element> m_innerURLElement;
169     RefPtr<Scrollbar> m_scrollbar;
170     bool m_isOverWidget; // Returns true if we are over a widget (and not in the border/padding area of a RenderWidget for example).
171
172     mutable std::unique_ptr<NodeSet> m_rectBasedTestResult;
173 };
174
175 WEBCORE_EXPORT String displayString(const String&, const Node*);
176
177 } // namespace WebCore
178
179 #endif // HitTestResult_h