summaryrefslogtreecommitdiffstats
path: root/WebCore/editing/Selection.h
diff options
context:
space:
mode:
Diffstat (limited to 'WebCore/editing/Selection.h')
-rw-r--r--WebCore/editing/Selection.h134
1 files changed, 134 insertions, 0 deletions
diff --git a/WebCore/editing/Selection.h b/WebCore/editing/Selection.h
new file mode 100644
index 0000000..ae50073
--- /dev/null
+++ b/WebCore/editing/Selection.h
@@ -0,0 +1,134 @@
+/*
+ * 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 Selection_h
+#define Selection_h
+
+#include "TextGranularity.h"
+#include "VisiblePosition.h"
+
+namespace WebCore {
+
+class Position;
+
+const EAffinity SEL_DEFAULT_AFFINITY = DOWNSTREAM;
+
+class Selection {
+public:
+ enum EState { NONE, CARET, RANGE };
+ enum EDirection { FORWARD, BACKWARD, RIGHT, LEFT };
+
+ Selection();
+
+ Selection(const Position&, EAffinity);
+ Selection(const Position&, const Position&, EAffinity);
+
+ Selection(const Range*, EAffinity = SEL_DEFAULT_AFFINITY);
+
+ Selection(const VisiblePosition&);
+ Selection(const VisiblePosition&, const VisiblePosition&);
+
+ static Selection selectionFromContentsOfNode(Node*);
+
+ EState state() const { return m_state; }
+
+ void setAffinity(EAffinity affinity) { m_affinity = affinity; }
+ EAffinity affinity() const { return m_affinity; }
+
+ void setBase(const Position&);
+ void setBase(const VisiblePosition&);
+ void setExtent(const Position&);
+ void setExtent(const VisiblePosition&);
+
+ Position base() const { return m_base; }
+ Position extent() const { return m_extent; }
+ Position start() const { return m_start; }
+ Position end() const { return m_end; }
+
+ VisiblePosition visibleStart() const { return VisiblePosition(m_start, isRange() ? DOWNSTREAM : affinity()); }
+ VisiblePosition visibleEnd() const { return VisiblePosition(m_end, isRange() ? UPSTREAM : affinity()); }
+
+ bool isNone() const { return state() == NONE; }
+ bool isCaret() const { return state() == CARET; }
+ bool isRange() const { return state() == RANGE; }
+ bool isCaretOrRange() const { return state() != NONE; }
+
+ bool isBaseFirst() const { return m_baseIsFirst; }
+
+ bool expandUsingGranularity(TextGranularity granularity);
+ TextGranularity granularity() const { return m_granularity; }
+
+ PassRefPtr<Range> toRange() const;
+
+ Element* rootEditableElement() const;
+ bool isContentEditable() const;
+ bool isContentRichlyEditable() const;
+ Node* shadowTreeRootNode() const;
+
+ void debugPosition() const;
+
+#ifndef NDEBUG
+ void formatForDebugger(char* buffer, unsigned length) const;
+ void showTreeForThis() const;
+#endif
+
+ void setWithoutValidation(const Position&, const Position&);
+
+private:
+ void validate();
+ void adjustForEditableContent();
+
+ Position m_base; // base position for the selection
+ Position m_extent; // extent position for the selection
+ Position m_start; // start position for the selection
+ Position m_end; // end position for the selection
+
+ EAffinity m_affinity; // the upstream/downstream affinity of the caret
+ TextGranularity m_granularity; // granularity of start/end selection
+
+ // these are cached, can be recalculated by validate()
+ EState m_state; // the state of the selection
+ bool m_baseIsFirst; // true if base is before the extent
+};
+
+inline bool operator==(const Selection& a, const Selection& b)
+{
+ return a.start() == b.start() && a.end() == b.end() && a.affinity() == b.affinity() && a.granularity() == b.granularity() && a.isBaseFirst() == b.isBaseFirst();
+}
+
+inline bool operator!=(const Selection& a, const Selection& b)
+{
+ return !(a == b);
+}
+
+} // namespace WebCore
+
+#ifndef NDEBUG
+// Outside the WebCore namespace for ease of invocation from gdb.
+void showTree(const WebCore::Selection&);
+void showTree(const WebCore::Selection*);
+#endif
+
+#endif // Selection_h