OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2004, 2008 Apple Inc. All rights reserved. | 2 * Copyright (C) 2004, 2008 Apple Inc. All rights reserved. |
3 * | 3 * |
4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions | 5 * modification, are permitted provided that the following conditions |
6 * are met: | 6 * are met: |
7 * 1. Redistributions of source code must retain the above copyright | 7 * 1. Redistributions of source code must retain the above copyright |
8 * notice, this list of conditions and the following disclaimer. | 8 * notice, this list of conditions and the following disclaimer. |
9 * 2. Redistributions in binary form must reproduce the above copyright | 9 * 2. Redistributions in binary form must reproduce the above copyright |
10 * notice, this list of conditions and the following disclaimer in the | 10 * notice, this list of conditions and the following disclaimer in the |
(...skipping 12 matching lines...) Expand all Loading... |
23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
24 */ | 24 */ |
25 | 25 |
26 #ifndef VisiblePosition_h | 26 #ifndef VisiblePosition_h |
27 #define VisiblePosition_h | 27 #define VisiblePosition_h |
28 | 28 |
29 #include "core/CoreExport.h" | 29 #include "core/CoreExport.h" |
30 #include "core/editing/EditingBoundary.h" | 30 #include "core/editing/EditingBoundary.h" |
31 #include "core/editing/EphemeralRange.h" | 31 #include "core/editing/EphemeralRange.h" |
32 #include "core/editing/PositionWithAffinity.h" | 32 #include "core/editing/PositionWithAffinity.h" |
| 33 #include "core/editing/TextAffinity.h" |
33 #include "platform/heap/Handle.h" | 34 #include "platform/heap/Handle.h" |
34 #include "platform/text/TextDirection.h" | 35 #include "platform/text/TextDirection.h" |
35 | 36 |
36 namespace blink { | 37 namespace blink { |
37 | 38 |
38 // VisiblePosition default affinity is downstream because | 39 // VisiblePosition default affinity is downstream because |
39 // the callers do not really care (they just want the | 40 // the callers do not really care (they just want the |
40 // deep position without regard to line position), and this | 41 // deep position without regard to line position), and this |
41 // is cheaper than UPSTREAM | 42 // is cheaper than UPSTREAM |
42 #define VP_DEFAULT_AFFINITY DOWNSTREAM | 43 #define VP_DEFAULT_AFFINITY TextAffinity::Downstream |
43 | 44 |
44 // Callers who do not know where on the line the position is, | 45 // Callers who do not know where on the line the position is, |
45 // but would like UPSTREAM if at a line break or DOWNSTREAM | 46 // but would like UPSTREAM if at a line break or DOWNSTREAM |
46 // otherwise, need a clear way to specify that. The | 47 // otherwise, need a clear way to specify that. The |
47 // constructors auto-correct UPSTREAM to DOWNSTREAM if the | 48 // constructors auto-correct UPSTREAM to DOWNSTREAM if the |
48 // position is not at a line break. | 49 // position is not at a line break. |
49 #define VP_UPSTREAM_IF_POSSIBLE UPSTREAM | 50 #define VP_UPSTREAM_IF_POSSIBLE TextAffinity::Upstream |
50 | 51 |
51 class InlineBox; | 52 class InlineBox; |
52 class Range; | 53 class Range; |
53 | 54 |
54 // |VisiblePosition| is an immutable object representing "canonical position" | 55 // |VisiblePosition| is an immutable object representing "canonical position" |
55 // with affinity. | 56 // with affinity. |
56 // | 57 // |
57 // "canonical position" is roughly equivalent to a position where we can place | 58 // "canonical position" is roughly equivalent to a position where we can place |
58 // caret, see |canonicalPosition()| for actual definition. | 59 // caret, see |canonicalPosition()| for actual definition. |
59 // | 60 // |
60 // "affinity" represents a place of caret at wrapped line. UPSTREAM affinity | 61 // "affinity" represents a place of caret at wrapped line. UPSTREAM affinity |
61 // means caret is placed at end of line. DOWNSTREAM affinity means caret is | 62 // means caret is placed at end of line. DOWNSTREAM affinity means caret is |
62 // placed at start of line. | 63 // placed at start of line. |
63 // | 64 // |
64 // Example of affinity: | 65 // Example of affinity: |
65 // abc^def where "^" represent |Position| | 66 // abc^def where "^" represent |Position| |
66 // When above text line wrapped after "abc" | 67 // When above text line wrapped after "abc" |
67 // abc| UPSTREAM |VisiblePosition| | 68 // abc| UPSTREAM |VisiblePosition| |
68 // |def DOWNSTREAM |VisiblePosition| | 69 // |def DOWNSTREAM |VisiblePosition| |
69 // | 70 // |
70 // NOTE: UPSTREAM affinity will be used only if pos is at end of a wrapped line, | 71 // NOTE: UPSTREAM affinity will be used only if pos is at end of a wrapped line, |
71 // otherwise it will be converted to DOWNSTREAM. | 72 // otherwise it will be converted to DOWNSTREAM. |
72 class CORE_EXPORT VisiblePosition final { | 73 class CORE_EXPORT VisiblePosition final { |
73 DISALLOW_ALLOCATION(); | 74 DISALLOW_ALLOCATION(); |
74 public: | 75 public: |
75 VisiblePosition() : m_affinity(VP_DEFAULT_AFFINITY) { } | 76 VisiblePosition() : m_affinity(VP_DEFAULT_AFFINITY) { } |
76 explicit VisiblePosition(const Position&, EAffinity = VP_DEFAULT_AFFINITY); | 77 explicit VisiblePosition(const Position&, TextAffinity = VP_DEFAULT_AFFINITY
); |
77 explicit VisiblePosition(const PositionInComposedTree&, EAffinity = VP_DEFAU
LT_AFFINITY); | 78 explicit VisiblePosition(const PositionInComposedTree&, TextAffinity = VP_DE
FAULT_AFFINITY); |
78 explicit VisiblePosition(const PositionWithAffinity&); | 79 explicit VisiblePosition(const PositionWithAffinity&); |
79 | 80 |
80 // Intentionally delete |operator==()| and |operator!=()| for reducing | 81 // Intentionally delete |operator==()| and |operator!=()| for reducing |
81 // compilation error message. | 82 // compilation error message. |
82 // TODO(yosin) We'll have |equals()| when we have use cases of checking | 83 // TODO(yosin) We'll have |equals()| when we have use cases of checking |
83 // equality of both position and affinity. | 84 // equality of both position and affinity. |
84 bool operator==(const VisiblePosition&) const = delete; | 85 bool operator==(const VisiblePosition&) const = delete; |
85 bool operator!=(const VisiblePosition&) const = delete; | 86 bool operator!=(const VisiblePosition&) const = delete; |
86 | 87 |
87 bool isNull() const { return m_deepPosition.isNull(); } | 88 bool isNull() const { return m_deepPosition.isNull(); } |
88 bool isNotNull() const { return m_deepPosition.isNotNull(); } | 89 bool isNotNull() const { return m_deepPosition.isNotNull(); } |
89 bool isOrphan() const { return m_deepPosition.isOrphan(); } | 90 bool isOrphan() const { return m_deepPosition.isOrphan(); } |
90 | 91 |
91 Position deepEquivalent() const { return m_deepPosition; } | 92 Position deepEquivalent() const { return m_deepPosition; } |
92 Position toParentAnchoredPosition() const { return deepEquivalent().parentAn
choredEquivalent(); } | 93 Position toParentAnchoredPosition() const { return deepEquivalent().parentAn
choredEquivalent(); } |
93 PositionWithAffinity toPositionWithAffinity() const { return PositionWithAff
inity(m_deepPosition, m_affinity); } | 94 PositionWithAffinity toPositionWithAffinity() const { return PositionWithAff
inity(m_deepPosition, m_affinity); } |
94 EAffinity affinity() const { ASSERT(m_affinity == UPSTREAM || m_affinity ==
DOWNSTREAM); return m_affinity; } | 95 TextAffinity affinity() const { return m_affinity; } |
95 | 96 |
96 // next() and previous() will increment/decrement by a character cluster. | 97 // next() and previous() will increment/decrement by a character cluster. |
97 VisiblePosition next(EditingBoundaryCrossingRule = CanCrossEditingBoundary)
const; | 98 VisiblePosition next(EditingBoundaryCrossingRule = CanCrossEditingBoundary)
const; |
98 VisiblePosition previous(EditingBoundaryCrossingRule = CanCrossEditingBounda
ry) const; | 99 VisiblePosition previous(EditingBoundaryCrossingRule = CanCrossEditingBounda
ry) const; |
99 VisiblePosition honorEditingBoundaryAtOrBefore(const VisiblePosition&) const
; | 100 VisiblePosition honorEditingBoundaryAtOrBefore(const VisiblePosition&) const
; |
100 VisiblePosition honorEditingBoundaryAtOrAfter(const VisiblePosition&) const; | 101 VisiblePosition honorEditingBoundaryAtOrAfter(const VisiblePosition&) const; |
101 VisiblePosition skipToStartOfEditingBoundary(const VisiblePosition&) const; | 102 VisiblePosition skipToStartOfEditingBoundary(const VisiblePosition&) const; |
102 VisiblePosition skipToEndOfEditingBoundary(const VisiblePosition&) const; | 103 VisiblePosition skipToEndOfEditingBoundary(const VisiblePosition&) const; |
103 | 104 |
104 VisiblePosition left() const; | 105 VisiblePosition left() const; |
(...skipping 16 matching lines...) Expand all Loading... |
121 DECLARE_TRACE(); | 122 DECLARE_TRACE(); |
122 | 123 |
123 #ifndef NDEBUG | 124 #ifndef NDEBUG |
124 void debugPosition(const char* msg = "") const; | 125 void debugPosition(const char* msg = "") const; |
125 void formatForDebugger(char* buffer, unsigned length) const; | 126 void formatForDebugger(char* buffer, unsigned length) const; |
126 void showTreeForThis() const; | 127 void showTreeForThis() const; |
127 #endif | 128 #endif |
128 | 129 |
129 private: | 130 private: |
130 template<typename Strategy> | 131 template<typename Strategy> |
131 void init(const PositionAlgorithm<Strategy>&, EAffinity); | 132 void init(const PositionAlgorithm<Strategy>&, TextAffinity); |
132 | 133 |
133 Position leftVisuallyDistinctCandidate() const; | 134 Position leftVisuallyDistinctCandidate() const; |
134 Position rightVisuallyDistinctCandidate() const; | 135 Position rightVisuallyDistinctCandidate() const; |
135 | 136 |
136 Position m_deepPosition; | 137 Position m_deepPosition; |
137 EAffinity m_affinity; | 138 TextAffinity m_affinity; |
138 }; | 139 }; |
139 | 140 |
140 // TODO(yosin) We should move |computeInlineBoxPosition()| to "VisibleUnits.h" | 141 // TODO(yosin) We should move |computeInlineBoxPosition()| to "VisibleUnits.h" |
141 // with |Position| version. | 142 // with |Position| version. |
142 inline InlineBoxPosition computeInlineBoxPosition(const VisiblePosition& positio
n) | 143 inline InlineBoxPosition computeInlineBoxPosition(const VisiblePosition& positio
n) |
143 { | 144 { |
144 return position.deepEquivalent().computeInlineBoxPosition(position.affinity(
)); | 145 return position.deepEquivalent().computeInlineBoxPosition(position.affinity(
)); |
145 } | 146 } |
146 | 147 |
147 EphemeralRange makeRange(const VisiblePosition&, const VisiblePosition&); | 148 EphemeralRange makeRange(const VisiblePosition&, const VisiblePosition&); |
148 | 149 |
149 CORE_EXPORT Position canonicalPositionOf(const Position&); | 150 CORE_EXPORT Position canonicalPositionOf(const Position&); |
150 CORE_EXPORT PositionInComposedTree canonicalPositionOf(const PositionInComposedT
ree&); | 151 CORE_EXPORT PositionInComposedTree canonicalPositionOf(const PositionInComposedT
ree&); |
151 PositionWithAffinity honorEditingBoundaryAtOrBeforeOf(const PositionWithAffinity
&, const Position& anchor); | 152 PositionWithAffinity honorEditingBoundaryAtOrBeforeOf(const PositionWithAffinity
&, const Position& anchor); |
152 PositionInComposedTreeWithAffinity honorEditingBoundaryAtOrBeforeOf(const Positi
onInComposedTreeWithAffinity&, const PositionInComposedTree& anchor); | 153 PositionInComposedTreeWithAffinity honorEditingBoundaryAtOrBeforeOf(const Positi
onInComposedTreeWithAffinity&, const PositionInComposedTree& anchor); |
153 | 154 |
154 } // namespace blink | 155 } // namespace blink |
155 | 156 |
156 #ifndef NDEBUG | 157 #ifndef NDEBUG |
157 // Outside the WebCore namespace for ease of invocation from gdb. | 158 // Outside the WebCore namespace for ease of invocation from gdb. |
158 void showTree(const blink::VisiblePosition*); | 159 void showTree(const blink::VisiblePosition*); |
159 void showTree(const blink::VisiblePosition&); | 160 void showTree(const blink::VisiblePosition&); |
160 #endif | 161 #endif |
161 | 162 |
162 #endif // VisiblePosition_h | 163 #endif // VisiblePosition_h |
OLD | NEW |