RangeImpl.hpp
上传用户:huihehuasu
上传日期:2007-01-10
资源大小:6948k
文件大小:7k
源码类别:

xml/soap/webservice

开发平台:

C/C++

  1. #ifndef RangeImpl_HEADER_GUARD_
  2. #define RangeImpl_HEADER_GUARD_
  3. /*
  4.  * The Apache Software License, Version 1.1
  5.  *
  6.  * Copyright (c) 1999-2000 The Apache Software Foundation.  All rights
  7.  * reserved.
  8.  *
  9.  * Redistribution and use in source and binary forms, with or without
  10.  * modification, are permitted provided that the following conditions
  11.  * are met:
  12.  *
  13.  * 1. Redistributions of source code must retain the above copyright
  14.  *    notice, this list of conditions and the following disclaimer.
  15.  *
  16.  * 2. Redistributions in binary form must reproduce the above copyright
  17.  *    notice, this list of conditions and the following disclaimer in
  18.  *    the documentation and/or other materials provided with the
  19.  *    distribution.
  20.  *
  21.  * 3. The end-user documentation included with the redistribution,
  22.  *    if any, must include the following acknowledgment:
  23.  *       "This product includes software developed by the
  24.  *        Apache Software Foundation (http://www.apache.org/)."
  25.  *    Alternately, this acknowledgment may appear in the software itself,
  26.  *    if and wherever such third-party acknowledgments normally appear.
  27.  *
  28.  * 4. The names "Xerces" and "Apache Software Foundation" must
  29.  *    not be used to endorse or promote products derived from this
  30.  *    software without prior written permission. For written
  31.  *    permission, please contact apache@apache.org.
  32.  *
  33.  * 5. Products derived from this software may not be called "Apache",
  34.  *    nor may "Apache" appear in their name, without prior written
  35.  *    permission of the Apache Software Foundation.
  36.  *
  37.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  38.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  39.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  40.  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  41.  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  42.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  43.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  44.  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  45.  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  46.  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  47.  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  48.  * SUCH DAMAGE.
  49.  * ====================================================================
  50.  *
  51.  * This software consists of voluntary contributions made by many
  52.  * individuals on behalf of the Apache Software Foundation, and was
  53.  * originally based on software copyright (c) 1999, International
  54.  * Business Machines, Inc., http://www.ibm.com .  For more information
  55.  * on the Apache Software Foundation, please see
  56.  * <http://www.apache.org/>.
  57.  */
  58.  /*
  59.  * $Id: RangeImpl.hpp,v 1.4 2000/12/06 19:42:46 tng Exp $
  60.  */
  61. #include "DOM_Node.hpp"
  62. #include "RefCountedImpl.hpp"
  63. #include "DOM_Range.hpp"
  64. #include "DOM_Text.hpp"
  65. #include "DOM_Document.hpp"
  66. #include <util/RefVectorOf.hpp>
  67. typedef RefVectorOf<RangeImpl> Ranges;
  68.  
  69. class CDOM_EXPORT RangeImpl : public RefCountedImpl {
  70. public:    
  71.     //c'tor
  72.     RangeImpl(DOM_Document doc);
  73.     RangeImpl(const RangeImpl& other);
  74.     //d'tor
  75.     ~RangeImpl();
  76.     //referencing related functions
  77.     virtual void                unreferenced();
  78.     
  79.     //getter functions
  80.     DOM_Node    getStartContainer() const;
  81.     unsigned    int getStartOffset() const;
  82.     DOM_Node    getEndContainer() const;
  83.     unsigned int getEndOffset() const;
  84.     
  85.     
  86.     
  87.     void        collapse(bool toStart);
  88.     bool        getCollapsed() const;
  89.     void        setStartBefore(const DOM_Node& node);
  90.     void        setStartAfter(const DOM_Node& node);
  91.     void        setEndBefore(const DOM_Node& node);
  92.     void        setEndAfter(const DOM_Node& node);
  93.     void        setStart(const DOM_Node& node, unsigned int offset);
  94.     void        setEnd(const DOM_Node& node, unsigned int offset);
  95.     void        selectNode(const DOM_Node& node);
  96.     void        selectNodeContents(const DOM_Node& node);
  97.    
  98.     short       compareBoundaryPoints(DOM_Range::CompareHow how, RangeImpl* range) const;
  99.    
  100.     void        detach();
  101.    
  102.     void        deleteContents();
  103.     
  104.     RangeImpl*  cloneRange() const;
  105.     DOMString   toString() const;    
  106.     DOM_Document getDocument();
  107.     void        surroundContents(DOM_Node& node);
  108.     DOM_DocumentFragment extractContents();
  109.     DOM_DocumentFragment cloneContents() const;
  110.     void        insertNode(DOM_Node& newNode);
  111.     const DOM_Node    getCommonAncestorContainer() const;
  112.     // functions to inform all existing valid ranges about a change
  113.     void updateSplitInfo(TextImpl* oldNode, TextImpl* startNode, unsigned int offset);
  114.     void updateRangeForInsertedNode(NodeImpl* node);
  115.     void receiveReplacedText(NodeImpl* node);
  116.     void updateRangeForDeletedText(DOM_Node& node, unsigned int offset, int count);
  117.     void updateRangeForDeletedNode(NodeImpl* node);
  118. private:
  119.     enum TraversalType {
  120.         EXTRACT_CONTENTS = 1,
  121.         CLONE_CONTENTS   = 2,
  122.         DELETE_CONTENTS  = 3
  123.     };
  124.     enum TraversePoint {
  125.         BEFORE  = -1,    
  126.         START   = 0,
  127.         AFTER   = 1
  128.     };
  129.     //setter functions
  130.     void        setStartContainer(const DOM_Node& node); 
  131.     void        setStartOffset(unsigned int offset) ;
  132.     void        setEndContainer(const DOM_Node& node);
  133.     void        setEndOffset(unsigned int offset) ;
  134.     //misc functions
  135.     void        validateNode(const DOM_Node& node) const;
  136.     bool        isValidAncestorType(const DOM_Node& node) const; 
  137.     bool        hasLegalRootContainer(const DOM_Node& node) const;
  138.     bool        isLegalContainedNode(const DOM_Node& node ) const;
  139.     void        checkIndex(const DOM_Node& node, unsigned int offset) const;
  140.     static bool isAncestorOf(const DOM_Node& a, const DOM_Node& b);
  141.     
  142.     unsigned short indexOf(const DOM_Node& child, const DOM_Node& parent) const;
  143.     const DOM_Node    commonAncestorOf(const DOM_Node& pointA, const DOM_Node& pointB) const;
  144.     DOM_Node    nextNode(const DOM_Node& node, bool visitChildren) const;
  145.     DOM_DocumentFragment traverseContents(TraversalType type);
  146.     void        checkReadOnly(DOM_Node& start, DOM_Node& end, 
  147.                     unsigned int starOffset, unsigned int endOffset);
  148.     void        recurseTreeAndCheck(DOM_Node& start, DOM_Node& end);
  149.     DOM_Node    removeChild(DOM_Node& parent, DOM_Node& child);
  150.     DOM_DocumentFragment traverseSameContainer( int how );
  151.     DOM_DocumentFragment traverseCommonStartContainer( DOM_Node endAncestor, int how );
  152.     DOM_DocumentFragment traverseCommonEndContainer( DOM_Node startAncestor, int how );
  153.     DOM_DocumentFragment traverseCommonAncestors( DOM_Node startAncestor, DOM_Node endAncestor, int how );
  154.     DOM_Node    traverseRightBoundary( DOM_Node root, int how );
  155.     DOM_Node    traverseLeftBoundary( DOM_Node root, int how );
  156.     DOM_Node    traverseNode( DOM_Node n, bool isFullySelected, bool isLeft, int how );
  157.     DOM_Node    traverseFullySelected( DOM_Node n, int how );
  158.     DOM_Node    traversePartiallySelected( DOM_Node n, int how );
  159.     DOM_Node    traverseTextNode( DOM_Node n, bool isLeft, int how );
  160.     DOM_Node    getSelectedNode( DOM_Node container, int offset );
  161.    
  162.     //private data 
  163.     DOM_Node        fStartContainer;
  164.     unsigned int    fStartOffset;
  165.     DOM_Node        fEndContainer;
  166.     unsigned int    fEndOffset;
  167.     bool            fCollapsed;
  168.     DOM_Document    fDocument;
  169.     bool            fDetached;
  170.     
  171.     DOM_Node        fRemoveChild;
  172.     
  173. };
  174. #endif