RangeImpl.hpp
上传用户:zhuqijet
上传日期:2013-06-25
资源大小:10074k
文件大小:8k
源码类别:

词法分析

开发平台:

Visual 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-2002 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.3 2002/11/04 15:04:44 tng Exp $
  60.  */
  61. //
  62. //  This file is part of the internal implementation of the C++ XML DOM.
  63. //  It should NOT be included or used directly by application programs.
  64. //
  65. //  Applications should include the file <xercesc/dom/deprecated/DOM.hpp> for the entire
  66. //  DOM API, or DOM_*.hpp for individual DOM classes, where the class
  67. //  name is substituded for the *.
  68. //
  69. #include "DOM_Node.hpp"
  70. #include "RefCountedImpl.hpp"
  71. #include "DOM_Range.hpp"
  72. #include "DOM_Text.hpp"
  73. #include "DOM_Document.hpp"
  74. #include <xercesc/util/RefVectorOf.hpp>
  75. XERCES_CPP_NAMESPACE_BEGIN
  76. typedef RefVectorOf<RangeImpl> Ranges;
  77. class CDOM_EXPORT RangeImpl : public RefCountedImpl {
  78. public:
  79.     //c'tor
  80.     RangeImpl(DOM_Document doc);
  81.     RangeImpl(const RangeImpl& other);
  82.     //d'tor
  83.     ~RangeImpl();
  84.     //referencing related functions
  85.     virtual void                unreferenced();
  86.     //getter functions
  87.     DOM_Node    getStartContainer() const;
  88.     unsigned    int getStartOffset() const;
  89.     DOM_Node    getEndContainer() const;
  90.     unsigned int getEndOffset() const;
  91.     void        collapse(bool toStart);
  92.     bool        getCollapsed() const;
  93.     void        setStartBefore(const DOM_Node& node);
  94.     void        setStartAfter(const DOM_Node& node);
  95.     void        setEndBefore(const DOM_Node& node);
  96.     void        setEndAfter(const DOM_Node& node);
  97.     void        setStart(const DOM_Node& node, unsigned int offset);
  98.     void        setEnd(const DOM_Node& node, unsigned int offset);
  99.     void        selectNode(const DOM_Node& node);
  100.     void        selectNodeContents(const DOM_Node& node);
  101.     short       compareBoundaryPoints(DOM_Range::CompareHow how, RangeImpl* range) const;
  102.     void        detach();
  103.     void        deleteContents();
  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.     unsigned short indexOf(const DOM_Node& child, const DOM_Node& parent) const;
  142.     const DOM_Node    commonAncestorOf(const DOM_Node& pointA, const DOM_Node& pointB) const;
  143.     DOM_Node    nextNode(const DOM_Node& node, bool visitChildren) const;
  144.     DOM_DocumentFragment traverseContents(TraversalType type);
  145.     void        checkReadOnly(DOM_Node& start, DOM_Node& end,
  146.                     unsigned int starOffset, unsigned int endOffset);
  147.     void        recurseTreeAndCheck(DOM_Node& start, DOM_Node& end);
  148.     DOM_Node    removeChild(DOM_Node& parent, DOM_Node& child);
  149.     DOM_DocumentFragment traverseSameContainer( int how );
  150.     DOM_DocumentFragment traverseCommonStartContainer( DOM_Node endAncestor, int how );
  151.     DOM_DocumentFragment traverseCommonEndContainer( DOM_Node startAncestor, int how );
  152.     DOM_DocumentFragment traverseCommonAncestors( DOM_Node startAncestor, DOM_Node endAncestor, int how );
  153.     DOM_Node    traverseRightBoundary( DOM_Node root, int how );
  154.     DOM_Node    traverseLeftBoundary( DOM_Node root, int how );
  155.     DOM_Node    traverseNode( DOM_Node n, bool isFullySelected, bool isLeft, int how );
  156.     DOM_Node    traverseFullySelected( DOM_Node n, int how );
  157.     DOM_Node    traversePartiallySelected( DOM_Node n, int how );
  158.     DOM_Node    traverseTextNode( DOM_Node n, bool isLeft, int how );
  159.     DOM_Node    getSelectedNode( DOM_Node container, int offset );
  160.     //private data
  161.     DOM_Node        fStartContainer;
  162.     unsigned int    fStartOffset;
  163.     DOM_Node        fEndContainer;
  164.     unsigned int    fEndOffset;
  165.     bool            fCollapsed;
  166.     DOM_Document    fDocument;
  167.     bool            fDetached;
  168.     DOM_Node        fRemoveChild;
  169. };
  170. XERCES_CPP_NAMESPACE_END
  171. #endif