1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185
|
/*
* Copyright (C) 2004 Apple Computer, Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef SelectionController_h
#define SelectionController_h
#include "IntRect.h"
#include "Selection.h"
#include "Range.h"
#include <wtf/Noncopyable.h>
namespace WebCore {
class Frame;
class GraphicsContext;
class RenderObject;
class VisiblePosition;
class SelectionController : Noncopyable {
public:
enum EAlteration { MOVE, EXTEND };
enum EDirection { FORWARD, BACKWARD, RIGHT, LEFT };
SelectionController(Frame* = 0, bool isDragCaretController = false);
Element* rootEditableElement() const { return m_sel.rootEditableElement(); }
bool isContentEditable() const { return m_sel.isContentEditable(); }
bool isContentRichlyEditable() const { return m_sel.isContentRichlyEditable(); }
void moveTo(const Range*, EAffinity, bool userTriggered = false);
void moveTo(const VisiblePosition&, bool userTriggered = false);
void moveTo(const VisiblePosition&, const VisiblePosition&, bool userTriggered = false);
void moveTo(const Position&, EAffinity, bool userTriggered = false);
void moveTo(const Position&, const Position&, EAffinity, bool userTriggered = false);
const Selection& selection() const { return m_sel; }
void setSelection(const Selection&, bool closeTyping = true, bool clearTypingStyle = true, bool userTriggered = false);
bool setSelectedRange(Range*, EAffinity, bool closeTyping);
void selectAll();
void clear();
// Call this after doing user-triggered selections to make it easy to delete the frame you entirely selected.
void selectFrameElementInParentIfFullySelected();
bool contains(const IntPoint&);
Selection::EState state() const { return m_sel.state(); }
EAffinity affinity() const { return m_sel.affinity(); }
bool modify(EAlteration, EDirection, TextGranularity, bool userTriggered = false);
bool modify(EAlteration, int verticalDistance, bool userTriggered = false);
bool expandUsingGranularity(TextGranularity);
void setBase(const VisiblePosition&, bool userTriggered = false);
void setBase(const Position&, EAffinity, bool userTriggered = false);
void setExtent(const VisiblePosition&, bool userTriggered = false);
void setExtent(const Position&, EAffinity, bool userTriggered = false);
Position base() const { return m_sel.base(); }
Position extent() const { return m_sel.extent(); }
Position start() const { return m_sel.start(); }
Position end() const { return m_sel.end(); }
IntRect caretRect() const;
void setNeedsLayout(bool flag = true);
void setLastChangeWasHorizontalExtension(bool b) { m_lastChangeWasHorizontalExtension = b; }
void willBeModified(EAlteration, EDirection);
bool isNone() const { return m_sel.isNone(); }
bool isCaret() const { return m_sel.isCaret(); }
bool isRange() const { return m_sel.isRange(); }
bool isCaretOrRange() const { return m_sel.isCaretOrRange(); }
bool isInPasswordField() const;
bool isInsideNode() const;
PassRefPtr<Range> toRange() const { return m_sel.toRange(); }
void debugRenderer(RenderObject*, bool selected) const;
void nodeWillBeRemoved(Node*);
bool recomputeCaretRect(); // returns true if caret rect moved
void invalidateCaretRect();
void paintCaret(GraphicsContext*, const IntRect&);
// Used to suspend caret blinking while the mouse is down.
void setCaretBlinkingSuspended(bool suspended) { m_isCaretBlinkingSuspended = suspended; }
bool isCaretBlinkingSuspended() const { return m_isCaretBlinkingSuspended; }
// Focus
void setFocused(bool);
bool isFocusedAndActive() const;
void pageActivationChanged();
#ifndef NDEBUG
void formatForDebugger(char* buffer, unsigned length) const;
void showTreeForThis() const;
#endif
private:
enum EPositionType { START, END, BASE, EXTENT };
VisiblePosition modifyExtendingRightForward(TextGranularity);
VisiblePosition modifyMovingRight(TextGranularity);
VisiblePosition modifyMovingForward(TextGranularity);
VisiblePosition modifyExtendingLeftBackward(TextGranularity);
VisiblePosition modifyMovingLeft(TextGranularity);
VisiblePosition modifyMovingBackward(TextGranularity);
void layout();
IntRect caretRepaintRect() const;
int xPosForVerticalArrowNavigation(EPositionType);
#if PLATFORM(MAC)
void notifyAccessibilityForSelectionChange();
#else
void notifyAccessibilityForSelectionChange() {};
#endif
void focusedOrActiveStateChanged();
Selection m_sel;
IntRect m_caretRect; // caret coordinates, size, and position
// m_caretPositionOnLayout stores the scroll offset on the previous call to SelectionController::layout().
// When asked for caretRect(), we correct m_caretRect for offset due to scrolling since the last layout().
// This is faster than doing another layout().
IntPoint m_caretPositionOnLayout;
bool m_needsLayout : 1; // true if the caret and expectedVisible rectangles need to be calculated
bool m_lastChangeWasHorizontalExtension : 1;
Frame* m_frame;
bool m_isDragCaretController;
bool m_isCaretBlinkingSuspended;
int m_xPosForVerticalArrowNavigation;
bool m_focused;
};
inline bool operator==(const SelectionController& a, const SelectionController& b)
{
return a.start() == b.start() && a.end() == b.end() && a.affinity() == b.affinity();
}
inline bool operator!=(const SelectionController& a, const SelectionController& b)
{
return !(a == b);
}
} // namespace WebCore
#ifndef NDEBUG
// Outside the WebCore namespace for ease of invocation from gdb.
void showTree(const WebCore::SelectionController&);
void showTree(const WebCore::SelectionController*);
#endif
#endif // SelectionController_h
|