diff -r 000000000000 -r 4f2f89ce4247 WebCore/page/DOMSelection.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/WebCore/page/DOMSelection.h Fri Sep 17 09:02:29 2010 +0300 @@ -0,0 +1,105 @@ +/* + * Copyright (C) 2007 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. + * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of + * its contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "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 OR ITS 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 DOMSelection_h +#define DOMSelection_h + +#include +#include +#include + +namespace WebCore { + + class Frame; + class Range; + class Node; + class String; + class VisibleSelection; + + typedef int ExceptionCode; + + class DOMSelection : public RefCounted { + public: + static PassRefPtr create(Frame* frame) { return adoptRef(new DOMSelection(frame)); } + + Frame* frame() const; + void disconnectFrame(); + + // Safari Selection Object API + // These methods return the valid equivalents of internal editing positions. + Node* baseNode() const; + Node* extentNode() const; + int baseOffset() const; + int extentOffset() const; + String type() const; + void setBaseAndExtent(Node* baseNode, int baseOffset, Node* extentNode, int extentOffset, ExceptionCode&); + void setPosition(Node*, int offset, ExceptionCode&); + void modify(const String& alter, const String& direction, const String& granularity); + + // Mozilla Selection Object API + // In Firefox, anchor/focus are the equal to the start/end of the selection, + // but reflect the direction in which the selection was made by the user. That does + // not mean that they are base/extent, since the base/extent don't reflect + // expansion. + // These methods return the valid equivalents of internal editing positions. + Node* anchorNode() const; + int anchorOffset() const; + Node* focusNode() const; + int focusOffset() const; + bool isCollapsed() const; + int rangeCount() const; + void collapse(Node*, int offset, ExceptionCode&); + void collapseToEnd(); + void collapseToStart(); + void extend(Node*, int offset, ExceptionCode&); + PassRefPtr getRangeAt(int, ExceptionCode&); + void removeAllRanges(); + void addRange(Range*); + void deleteFromDocument(); + bool containsNode(const Node*, bool partlyContained) const; + void selectAllChildren(Node*, ExceptionCode&); + + String toString(); + + // Microsoft Selection Object API + void empty(); + + private: + DOMSelection(Frame*); + + // Convenience method for accessors, does not NULL check m_frame. + const VisibleSelection& visibleSelection() const; + + bool isValidForPosition(Node*) const; + Frame* m_frame; + }; + +} // namespace WebCore + +#endif // DOMSelection_h