2 * Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010 Apple Inc. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
7 * 1. Redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution.
13 * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR
17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 #ifndef FrameSelection_h
27 #define FrameSelection_h
29 #include "core/dom/Range.h"
30 #include "core/editing/Caret.h"
31 #include "core/editing/EditingStyle.h"
32 #include "core/editing/VisibleSelection.h"
33 #include "core/rendering/ScrollAlignment.h"
34 #include "platform/Timer.h"
35 #include "platform/geometry/IntRect.h"
36 #include "platform/geometry/LayoutRect.h"
37 #include "wtf/Noncopyable.h"
43 class GraphicsContext;
44 class HTMLFormElement;
45 class MutableStylePropertySet;
50 class VisiblePosition;
52 enum EUserTriggered { NotUserTriggered = 0, UserTriggered = 1 };
54 enum RevealExtentOption {
59 class FrameSelection : private CaretBase {
60 WTF_MAKE_NONCOPYABLE(FrameSelection);
61 WTF_MAKE_FAST_ALLOCATED;
63 enum EAlteration { AlterationMove, AlterationExtend };
64 enum CursorAlignOnScroll { AlignCursorOnScrollIfNeeded,
65 AlignCursorOnScrollAlways };
66 enum SetSelectionOption {
67 // 1 << 0 is reserved for EUserTriggered
69 ClearTypingStyle = 1 << 2,
70 SpellCorrectionTriggered = 1 << 3,
71 DoNotSetFocus = 1 << 4,
72 DoNotUpdateAppearance = 1 << 5,
74 typedef unsigned SetSelectionOptions; // Union of values in SetSelectionOption and EUserTriggered
75 static inline EUserTriggered selectionOptionsToUserTriggered(SetSelectionOptions options)
77 return static_cast<EUserTriggered>(options & UserTriggered);
80 explicit FrameSelection(Frame* = 0);
82 Element* rootEditableElement() const { return m_selection.rootEditableElement(); }
83 Element* rootEditableElementOrDocumentElement() const;
84 Node* rootEditableElementOrTreeScopeRootNode() const;
86 bool rendererIsEditable() const { return m_selection.rendererIsEditable(); }
87 bool isContentEditable() const { return m_selection.isContentEditable(); }
88 bool isContentRichlyEditable() const { return m_selection.isContentRichlyEditable(); }
90 void moveTo(const VisiblePosition&, EUserTriggered = NotUserTriggered, CursorAlignOnScroll = AlignCursorOnScrollIfNeeded);
91 void moveTo(const VisiblePosition&, const VisiblePosition&, EUserTriggered = NotUserTriggered);
92 void moveTo(const Position&, EAffinity, EUserTriggered = NotUserTriggered);
94 const VisibleSelection& selection() const { return m_selection; }
95 void setSelection(const VisibleSelection&, SetSelectionOptions = CloseTyping | ClearTypingStyle, CursorAlignOnScroll = AlignCursorOnScrollIfNeeded, TextGranularity = CharacterGranularity);
96 void setSelection(const VisibleSelection& selection, TextGranularity granularity) { setSelection(selection, CloseTyping | ClearTypingStyle, AlignCursorOnScrollIfNeeded, granularity); }
97 bool setSelectedRange(Range*, EAffinity, bool closeTyping);
100 void prepareForDestruction();
102 // Call this after doing user-triggered selections to make it easy to delete the frame you entirely selected.
103 void selectFrameElementInParentIfFullySelected();
105 bool contains(const LayoutPoint&);
107 SelectionType selectionType() const { return m_selection.selectionType(); }
109 EAffinity affinity() const { return m_selection.affinity(); }
111 bool modify(EAlteration, SelectionDirection, TextGranularity, EUserTriggered = NotUserTriggered);
112 enum VerticalDirection { DirectionUp, DirectionDown };
113 bool modify(EAlteration, unsigned verticalDistance, VerticalDirection, EUserTriggered = NotUserTriggered, CursorAlignOnScroll = AlignCursorOnScrollIfNeeded);
115 TextGranularity granularity() const { return m_granularity; }
117 void setStart(const VisiblePosition &, EUserTriggered = NotUserTriggered);
118 void setEnd(const VisiblePosition &, EUserTriggered = NotUserTriggered);
120 void setBase(const VisiblePosition&, EUserTriggered = NotUserTriggered);
121 void setExtent(const VisiblePosition&, EUserTriggered = NotUserTriggered);
123 Position base() const { return m_selection.base(); }
124 Position extent() const { return m_selection.extent(); }
125 Position start() const { return m_selection.start(); }
126 Position end() const { return m_selection.end(); }
128 // Return the renderer that is responsible for painting the caret (in the selection start node)
129 RenderObject* caretRenderer() const;
131 // Caret rect local to the caret's renderer
132 LayoutRect localCaretRect();
134 // Bounds of (possibly transformed) caret in absolute coords
135 IntRect absoluteCaretBounds();
136 void setCaretRectNeedsUpdate() { CaretBase::setCaretRectNeedsUpdate(); }
138 void didChangeFocus();
139 void willBeModified(EAlteration, SelectionDirection);
141 bool isNone() const { return m_selection.isNone(); }
142 bool isCaret() const { return m_selection.isCaret(); }
143 bool isRange() const { return m_selection.isRange(); }
144 bool isCaretOrRange() const { return m_selection.isCaretOrRange(); }
145 bool isInPasswordField() const;
147 PassRefPtr<Range> toNormalizedRange() const { return m_selection.toNormalizedRange(); }
149 void nodeWillBeRemoved(Node&);
150 void didUpdateCharacterData(CharacterData*, unsigned offset, unsigned oldLength, unsigned newLength);
151 void didMergeTextNodes(const Text& oldNode, unsigned offset);
152 void didSplitTextNode(const Text& oldNode);
154 void setCaretVisible(bool caretIsVisible) { setCaretVisibility(caretIsVisible ? Visible : Hidden); }
155 bool recomputeCaretRect();
156 void invalidateCaretRect();
157 void paintCaret(GraphicsContext*, const LayoutPoint&, const LayoutRect& clipRect);
159 // Used to suspend caret blinking while the mouse is down.
160 void setCaretBlinkingSuspended(bool suspended) { m_isCaretBlinkingSuspended = suspended; }
161 bool isCaretBlinkingSuspended() const { return m_isCaretBlinkingSuspended; }
164 void setFocused(bool);
165 bool isFocused() const { return m_focused; }
166 bool isFocusedAndActive() const;
167 void pageActivationChanged();
170 void updateAppearance();
172 void updateSecureKeyboardEntryIfActive();
175 void formatForDebugger(char* buffer, unsigned length) const;
176 void showTreeForThis() const;
179 enum EndPointsAdjustmentMode { AdjustEndpointsAtBidiBoundary, DoNotAdjsutEndpoints };
180 void setNonDirectionalSelectionIfNeeded(const VisibleSelection&, TextGranularity, EndPointsAdjustmentMode = DoNotAdjsutEndpoints);
181 void setFocusedNodeIfNeeded();
182 void notifyRendererOfSelectionChange(EUserTriggered);
184 EditingStyle* typingStyle() const;
185 void setTypingStyle(PassRefPtr<EditingStyle>);
186 void clearTypingStyle();
188 String selectedText() const;
189 String selectedTextForClipboard() const;
191 FloatRect bounds(bool clipToVisibleContent = true) const;
193 HTMLFormElement* currentForm() const;
195 void revealSelection(const ScrollAlignment& = ScrollAlignment::alignCenterIfNeeded, RevealExtentOption = DoNotRevealExtent);
196 void setSelectionFromNone();
198 void setShouldShowBlockCursor(bool);
201 enum EPositionType { START, END, BASE, EXTENT };
203 void respondToNodeModification(Node&, bool baseRemoved, bool extentRemoved, bool startRemoved, bool endRemoved);
204 TextDirection directionOfEnclosingBlock();
205 TextDirection directionOfSelection();
207 VisiblePosition positionForPlatform(bool isGetStart) const;
208 VisiblePosition startForPlatform() const;
209 VisiblePosition endForPlatform() const;
210 VisiblePosition nextWordPositionForPlatform(const VisiblePosition&);
212 VisiblePosition modifyExtendingRight(TextGranularity);
213 VisiblePosition modifyExtendingForward(TextGranularity);
214 VisiblePosition modifyMovingRight(TextGranularity);
215 VisiblePosition modifyMovingForward(TextGranularity);
216 VisiblePosition modifyExtendingLeft(TextGranularity);
217 VisiblePosition modifyExtendingBackward(TextGranularity);
218 VisiblePosition modifyMovingLeft(TextGranularity);
219 VisiblePosition modifyMovingBackward(TextGranularity);
221 LayoutUnit lineDirectionPointForBlockDirectionNavigation(EPositionType);
223 void notifyAccessibilityForSelectionChange();
225 void focusedOrActiveStateChanged();
227 void caretBlinkTimerFired(Timer<FrameSelection>*);
229 void setUseSecureKeyboardEntry(bool);
231 void setCaretVisibility(CaretVisibility);
232 bool shouldBlinkCaret() const;
234 bool dispatchSelectStart();
236 void updateSelectionIfNeeded(const Position& base, const Position& extent, const Position& start, const Position& end);
240 LayoutUnit m_xPosForVerticalArrowNavigation;
242 VisibleSelection m_selection;
243 VisiblePosition m_originalBase; // Used to store base before the adjustment at bidi boundary
244 TextGranularity m_granularity;
246 RefPtr<Node> m_previousCaretNode; // The last node which painted the caret. Retained for clearing the old caret when it moves.
248 RefPtr<EditingStyle> m_typingStyle;
250 Timer<FrameSelection> m_caretBlinkTimer;
251 // The painted bounds of the caret in absolute coordinates
252 IntRect m_absCaretBounds;
253 bool m_absCaretBoundsDirty : 1;
254 bool m_caretPaint : 1;
255 bool m_isCaretBlinkingSuspended : 1;
257 bool m_shouldShowBlockCursor : 1;
260 inline EditingStyle* FrameSelection::typingStyle() const
262 return m_typingStyle.get();
265 inline void FrameSelection::clearTypingStyle()
267 m_typingStyle.clear();
270 inline void FrameSelection::setTypingStyle(PassRefPtr<EditingStyle> style)
272 m_typingStyle = style;
274 } // namespace WebCore
277 // Outside the WebCore namespace for ease of invocation from gdb.
278 void showTree(const WebCore::FrameSelection&);
279 void showTree(const WebCore::FrameSelection*);
282 #endif // FrameSelection_h