diff options
author | The Android Open Source Project <initial-contribution@android.com> | 2009-03-03 19:30:52 -0800 |
---|---|---|
committer | The Android Open Source Project <initial-contribution@android.com> | 2009-03-03 19:30:52 -0800 |
commit | 8e35f3cfc7fba1d1c829dc557ebad6409cbe16a2 (patch) | |
tree | 11425ea0b299d6fb89c6d3618a22d97d5bf68d0f /WebCore/dom/Position.h | |
parent | 648161bb0edfc3d43db63caed5cc5213bc6cb78f (diff) | |
download | external_webkit-8e35f3cfc7fba1d1c829dc557ebad6409cbe16a2.zip external_webkit-8e35f3cfc7fba1d1c829dc557ebad6409cbe16a2.tar.gz external_webkit-8e35f3cfc7fba1d1c829dc557ebad6409cbe16a2.tar.bz2 |
auto import from //depot/cupcake/@135843
Diffstat (limited to 'WebCore/dom/Position.h')
-rw-r--r-- | WebCore/dom/Position.h | 135 |
1 files changed, 135 insertions, 0 deletions
diff --git a/WebCore/dom/Position.h b/WebCore/dom/Position.h new file mode 100644 index 0000000..2624238 --- /dev/null +++ b/WebCore/dom/Position.h @@ -0,0 +1,135 @@ +/* + * Copyright (C) 2004, 2006, 2008 Apple 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 Position_h +#define Position_h + +#include "TextAffinity.h" +#include "TextDirection.h" +#include <wtf/PassRefPtr.h> +#include <wtf/RefPtr.h> + +namespace WebCore { + +class CSSComputedStyleDeclaration; +class Element; +class InlineBox; +class Node; +class Range; +class RenderObject; + +enum EUsingComposedCharacters { NotUsingComposedCharacters = false, UsingComposedCharacters = true }; + +// FIXME: Reduce the number of operations we have on a Position. +// This should be more like a humble struct, without so many different +// member functions. We should find better homes for these functions. + +class Position { +public: + RefPtr<Node> container; + int posOffset; // to be renamed to offset when we get rid of offset() + + Position() : posOffset(0) { } + Position(PassRefPtr<Node> c, int o) : container(c), posOffset(o) { } + + void clear() { container.clear(); posOffset = 0; } + + Node* node() const { return container.get(); } + int offset() const { return posOffset; } + Element* documentElement() const; + + bool isNull() const { return !container; } + bool isNotNull() const { return container; } + + Element* element() const; + PassRefPtr<CSSComputedStyleDeclaration> computedStyle() const; + + // Move up or down the DOM by one position. + // Offsets are computed using render text for nodes that have renderers - but note that even when + // using composed characters, the result may be inside a single user-visible character if a ligature is formed. + Position previous(EUsingComposedCharacters usingComposedCharacters=NotUsingComposedCharacters) const; + Position next(EUsingComposedCharacters usingComposedCharacters=NotUsingComposedCharacters) const; + static int uncheckedPreviousOffset(const Node*, int current); + static int uncheckedNextOffset(const Node*, int current); + + bool atStart() const; + bool atEnd() const; + + // FIXME: Make these non-member functions and put them somewhere in the editing directory. + // These aren't really basic "position" operations. More high level editing helper functions. + Position leadingWhitespacePosition(EAffinity, bool considerNonCollapsibleWhitespace = false) const; + Position trailingWhitespacePosition(EAffinity, bool considerNonCollapsibleWhitespace = false) const; + + // These return useful visually equivalent positions. + Position upstream() const; + Position downstream() const; + + bool isCandidate() const; + bool inRenderedText() const; + bool isRenderedCharacter() const; + bool rendersInDifferentPosition(const Position&) const; + + void getInlineBoxAndOffset(EAffinity, InlineBox*&, int& caretOffset) const; + void getInlineBoxAndOffset(EAffinity, TextDirection primaryDirection, InlineBox*&, int& caretOffset) const; + + static bool hasRenderedNonAnonymousDescendantsWithHeight(RenderObject*); + static bool nodeIsUserSelectNone(Node*); + + void debugPosition(const char* msg = "") const; + +#ifndef NDEBUG + void formatForDebugger(char* buffer, unsigned length) const; + void showTreeForThis() const; +#endif + +private: + int renderedOffset() const; + + Position previousCharacterPosition(EAffinity) const; + Position nextCharacterPosition(EAffinity) const; +}; + +inline bool operator==(const Position& a, const Position& b) +{ + return a.container == b.container && a.posOffset == b.posOffset; +} + +inline bool operator!=(const Position& a, const Position& b) +{ + return !(a == b); +} + +Position startPosition(const Range*); +Position endPosition(const Range*); + +} // namespace WebCore + +#ifndef NDEBUG +// Outside the WebCore namespace for ease of invocation from gdb. +void showTree(const WebCore::Position&); +void showTree(const WebCore::Position*); +#endif + +#endif // Position_h |