<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>Xerces-C++: DOMRange Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.6 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li class="current"><a href="classes.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical List</span></a></li>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>DOMRange Class Reference</h1><!-- doxytag: class="DOMRange" -->
<p>
<a href="classDOMRange-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Public Contants</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9">CompareHow</a> { <a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a909a7df9afce10d0a9f6ae07a96183833">START_TO_START</a> = 0,
<a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9a002ea522f96d72c9c99f86269e9176a">START_TO_END</a> = 1,
<a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9af3b7f157d490024baf1b7b4736db134">END_TO_END</a> = 2,
<a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9e8f27dbcc33d9113cc55bc4b4255b287">END_TO_START</a> = 3
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Constants CompareHow. <a href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9">More...</a><br></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Destructor</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#fc4bac82009e31a64a9cb892769f241b">~DOMRange</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#fc4bac82009e31a64a9cb892769f241b"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 2</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classDOMNode.html">DOMNode</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#f4db1a7e3566b625edc162a281e735d2">getStartContainer</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classDOMNode.html" title="The DOMNode interface is the primary datatype for the entire Document Object Model...">DOMNode</a> within which the Range begins <dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. </td></tr>
</table>
</dl>
<a href="#f4db1a7e3566b625edc162a281e735d2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#3f1f2dccaefcc2686c3c527a82f5f0fd">getStartOffset</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Offset within the starting node of the Range. <a href="#3f1f2dccaefcc2686c3c527a82f5f0fd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classDOMNode.html">DOMNode</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#1be5b6cb356ca847a8e1eb5a9131c4ed">getEndContainer</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classDOMNode.html" title="The DOMNode interface is the primary datatype for the entire Document Object Model...">DOMNode</a> within which the Range ends <dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. </td></tr>
</table>
</dl>
<a href="#1be5b6cb356ca847a8e1eb5a9131c4ed"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#cafa27c9b763b71951088a545111c84b">getEndOffset</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Offset within the ending node of the Range. <a href="#cafa27c9b763b71951088a545111c84b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#654c1d89653bd03d39c6891130a0ee99">getCollapsed</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">TRUE if the Range is collapsed <dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. </td></tr>
</table>
</dl>
<a href="#654c1d89653bd03d39c6891130a0ee99"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual const <a class="el" href="classDOMNode.html">DOMNode</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#1e978223e6dce5643f6dd4489c5ef286">getCommonAncestorContainer</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The deepest common ancestor container of the Range's two boundary-points. <a href="#1e978223e6dce5643f6dd4489c5ef286"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#f25ec2bf59cbc16925c8e1931c953b33">setStart</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode, <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> offset)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the attributes describing the start of the Range. <a href="#f25ec2bf59cbc16925c8e1931c953b33"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#fd237c4bb732ccac0d04c4a85128ec6e">setEnd</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode, <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> offset)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the attributes describing the end of a Range. <a href="#fd237c4bb732ccac0d04c4a85128ec6e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#b109475fe2ecbf83596ffe6522bec541">setStartBefore</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the start position to be before a node. <a href="#b109475fe2ecbf83596ffe6522bec541"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#5188aa5fcdb9641a5ed8cfd52f5fd324">setStartAfter</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the start position to be after a node. <a href="#5188aa5fcdb9641a5ed8cfd52f5fd324"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#136cb62f6bbea91d59e6bf6b2ff9a71b">setEndBefore</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the end position to be before a node. <a href="#136cb62f6bbea91d59e6bf6b2ff9a71b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#ea76fe2447ffeb6866a944b7132b45c7">setEndAfter</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the end of a Range to be after a node. <a href="#ea76fe2447ffeb6866a944b7132b45c7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#54ceca8b36504f808f0948ffd8e3e8ac">collapse</a> (bool toStart)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Collapse a Range onto one of its boundary-points. <a href="#54ceca8b36504f808f0948ffd8e3e8ac"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#6c7e35df7eb6f376ca77db2cd31cc1c6">selectNode</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Select a node and its contents. <a href="#6c7e35df7eb6f376ca77db2cd31cc1c6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#a659d982cbaadd0574d564be5659843a">selectNodeContents</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Select the contents within a node. <a href="#a659d982cbaadd0574d564be5659843a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual short </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#775c42cb06ad3ff2d88bd101ea56ee99">compareBoundaryPoints</a> (<a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9">CompareHow</a> how, const <a class="el" href="classDOMRange.html">DOMRange</a> *sourceRange) const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Compare the boundary-points of two Ranges in a document. <a href="#775c42cb06ad3ff2d88bd101ea56ee99"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#f4fb2266db144e548b0da9f9877e684a">deleteContents</a> ()=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Removes the contents of a Range from the containing document or document fragment without returning a reference to the removed content. <a href="#f4fb2266db144e548b0da9f9877e684a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#e45136427cdc1dd1ac4c8580a4fd6b29">extractContents</a> ()=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Moves the contents of a Range from the containing document or document fragment to a new <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>. <a href="#e45136427cdc1dd1ac4c8580a4fd6b29"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#7dc35150107908c60499e850b8ee2233">cloneContents</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Duplicates the contents of a Range. <a href="#7dc35150107908c60499e850b8ee2233"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#b23067cbb829d88ffefa610aa4c2a9ee">insertNode</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *newNode)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Inserts a node into the <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a> or <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> at the start of the Range. <a href="#b23067cbb829d88ffefa610aa4c2a9ee"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#8e064aedbe31b4d6a1e14e1f8209923f">surroundContents</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *newParent)=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Reparents the contents of the Range to the given node and inserts the node at the position of the start of the Range. <a href="#8e064aedbe31b4d6a1e14e1f8209923f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classDOMRange.html">DOMRange</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#81ccdc2d93423697180c7b98a6019267">cloneRange</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Produces a new Range whose boundary-points are equal to the boundary-points of the Range. <a href="#81ccdc2d93423697180c7b98a6019267"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual const <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#fae8f92d83170d97f757f704eca7f52a">XMLCh</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#110663e653e493c1a6784422e117b1aa">toString</a> () const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the contents of a Range as a string. <a href="#110663e653e493c1a6784422e117b1aa"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a">detach</a> ()=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Called to indicate that the Range is no longer in use and that the implementation may relinquish any resources associated with this Range. <a href="#c7b3e797ad3f681f081a07836e369e3a"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Non-standard Extension</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#9a82e63c7b43806b67b048ff0323cf89">release</a> ()=0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Called to indicate that this Range is no longer in use and that the implementation may relinquish any resources associated with it. <a href="#9a82e63c7b43806b67b048ff0323cf89"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Hidden constructors</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#6e6606503a2023af378a32c90be021bf">DOMRange</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMRange.html#f8ec07eb322835f364d18ce0836c98d8">DOMRange</a> (const <a class="el" href="classDOMRange.html">DOMRange</a> &)</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
See also the <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113">Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. <dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
<hr><h2>Member Enumeration Documentation</h2>
<a class="anchor" name="1459ada3b7cbdd517b4104fa8a8af0a9"></a><!-- doxytag: member="DOMRange::CompareHow" ref="1459ada3b7cbdd517b4104fa8a8af0a9" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9">DOMRange::CompareHow</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Constants CompareHow.
<p>
<code>START_TO_START:</code> Compare start boundary-point of <code>sourceRange</code> to start boundary-point of Range on which <code>compareBoundaryPoints</code> is invoked.<p>
<code>START_TO_END:</code> Compare start boundary-point of <code>sourceRange</code> to end boundary-point of Range on which <code>compareBoundaryPoints</code> is invoked.<p>
<code>END_TO_END:</code> Compare end boundary-point of <code>sourceRange</code> to end boundary-point of Range on which <code>compareBoundaryPoints</code> is invoked.<p>
<code>END_TO_START:</code> Compare end boundary-point of <code>sourceRange</code> to start boundary-point of Range on which <code>compareBoundaryPoints</code> is invoked.<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
<dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" name="1459ada3b7cbdd517b4104fa8a8af0a909a7df9afce10d0a9f6ae07a96183833"></a><!-- doxytag: member="START_TO_START" ref="1459ada3b7cbdd517b4104fa8a8af0a909a7df9afce10d0a9f6ae07a96183833" args="" -->START_TO_START</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="1459ada3b7cbdd517b4104fa8a8af0a9a002ea522f96d72c9c99f86269e9176a"></a><!-- doxytag: member="START_TO_END" ref="1459ada3b7cbdd517b4104fa8a8af0a9a002ea522f96d72c9c99f86269e9176a" args="" -->START_TO_END</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="1459ada3b7cbdd517b4104fa8a8af0a9af3b7f157d490024baf1b7b4736db134"></a><!-- doxytag: member="END_TO_END" ref="1459ada3b7cbdd517b4104fa8a8af0a9af3b7f157d490024baf1b7b4736db134" args="" -->END_TO_END</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="1459ada3b7cbdd517b4104fa8a8af0a9e8f27dbcc33d9113cc55bc4b4255b287"></a><!-- doxytag: member="END_TO_START" ref="1459ada3b7cbdd517b4104fa8a8af0a9e8f27dbcc33d9113cc55bc4b4255b287" args="" -->END_TO_START</em> </td><td>
</td></tr>
</table>
</dl>
</div>
</div><p>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="6e6606503a2023af378a32c90be021bf"></a><!-- doxytag: member="DOMRange::DOMRange" ref="6e6606503a2023af378a32c90be021bf" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DOMRange::DOMRange </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="f8ec07eb322835f364d18ce0836c98d8"></a><!-- doxytag: member="DOMRange::DOMRange" ref="f8ec07eb322835f364d18ce0836c98d8" args="(const DOMRange &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DOMRange::DOMRange </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMRange.html">DOMRange</a> & </td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="fc4bac82009e31a64a9cb892769f241b"></a><!-- doxytag: member="DOMRange::~DOMRange" ref="fc4bac82009e31a64a9cb892769f241b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual DOMRange::~DOMRange </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Destructor.
<p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="f4db1a7e3566b625edc162a281e735d2"></a><!-- doxytag: member="DOMRange::getStartContainer" ref="f4db1a7e3566b625edc162a281e735d2" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getStartContainer </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<a class="el" href="classDOMNode.html" title="The DOMNode interface is the primary datatype for the entire Document Object Model...">DOMNode</a> within which the Range begins <dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. </td></tr>
</table>
</dl>
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="3f1f2dccaefcc2686c3c527a82f5f0fd"></a><!-- doxytag: member="DOMRange::getStartOffset" ref="3f1f2dccaefcc2686c3c527a82f5f0fd" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> DOMRange::getStartOffset </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Offset within the starting node of the Range.
<p>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="1be5b6cb356ca847a8e1eb5a9131c4ed"></a><!-- doxytag: member="DOMRange::getEndContainer" ref="1be5b6cb356ca847a8e1eb5a9131c4ed" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getEndContainer </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<a class="el" href="classDOMNode.html" title="The DOMNode interface is the primary datatype for the entire Document Object Model...">DOMNode</a> within which the Range ends <dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. </td></tr>
</table>
</dl>
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="cafa27c9b763b71951088a545111c84b"></a><!-- doxytag: member="DOMRange::getEndOffset" ref="cafa27c9b763b71951088a545111c84b" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> DOMRange::getEndOffset </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Offset within the ending node of the Range.
<p>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="654c1d89653bd03d39c6891130a0ee99"></a><!-- doxytag: member="DOMRange::getCollapsed" ref="654c1d89653bd03d39c6891130a0ee99" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual bool DOMRange::getCollapsed </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
TRUE if the Range is collapsed <dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. </td></tr>
</table>
</dl>
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="1e978223e6dce5643f6dd4489c5ef286"></a><!-- doxytag: member="DOMRange::getCommonAncestorContainer" ref="1e978223e6dce5643f6dd4489c5ef286" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual const <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getCommonAncestorContainer </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The deepest common ancestor container of the Range's two boundary-points.
<p>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="f25ec2bf59cbc16925c8e1931c953b33"></a><!-- doxytag: member="DOMRange::setStart" ref="f25ec2bf59cbc16925c8e1931c953b33" args="(const DOMNode *refNode, XMLSize_t offset)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::setStart </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>refNode</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> </td>
<td class="paramname"> <em>offset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the attributes describing the start of the Range.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>The <code>refNode</code> value. This parameter must be different from <code>null</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The <code>startOffset</code> value. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a>, or <a class="el" href="classDOMDocumentType.html" title="Each DOMDocument has a doctype attribute whose value is either null or a DOMDocumentType...">DOMDocumentType</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INDEX_SIZE_ERR: Raised if <code>offset</code> is negative or greater than the number of child units in <code>refNode</code>. Child units are 16-bit units if <code>refNode</code> is a type of <a class="el" href="classDOMCharacterData.html" title="The DOMCharacterData interface extends DOMNode with a set of attributes and methods...">DOMCharacterData</a> node (e.g., a <a class="el" href="classDOMText.html" title="The DOMText interface inherits from DOMCharacterData and represents the textual content...">DOMText</a> or <a class="el" href="classDOMComment.html" title="This interface inherits from CharacterData and represents the content of a comment...">DOMComment</a> node) or a <a class="el" href="classDOMProcessingInstruction.html" title="The DOMProcessingInstruction interface represents a "processing instruction"...">DOMProcessingInstruction</a> node. Child units are Nodes in all other cases. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. <br>
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="fd237c4bb732ccac0d04c4a85128ec6e"></a><!-- doxytag: member="DOMRange::setEnd" ref="fd237c4bb732ccac0d04c4a85128ec6e" args="(const DOMNode *refNode, XMLSize_t offset)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::setEnd </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>refNode</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> </td>
<td class="paramname"> <em>offset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the attributes describing the end of a Range.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>The <code>refNode</code> value. This parameter must be different from <code>null</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The <code>endOffset</code> value. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a>, or <a class="el" href="classDOMDocumentType.html" title="Each DOMDocument has a doctype attribute whose value is either null or a DOMDocumentType...">DOMDocumentType</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INDEX_SIZE_ERR: Raised if <code>offset</code> is negative or greater than the number of child units in <code>refNode</code>. Child units are 16-bit units if <code>refNode</code> is a type of <a class="el" href="classDOMCharacterData.html" title="The DOMCharacterData interface extends DOMNode with a set of attributes and methods...">DOMCharacterData</a> node (e.g., a <a class="el" href="classDOMText.html" title="The DOMText interface inherits from DOMCharacterData and represents the textual content...">DOMText</a> or <a class="el" href="classDOMComment.html" title="This interface inherits from CharacterData and represents the content of a comment...">DOMComment</a> node) or a <a class="el" href="classDOMProcessingInstruction.html" title="The DOMProcessingInstruction interface represents a "processing instruction"...">DOMProcessingInstruction</a> node. Child units are Nodes in all other cases. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. <br>
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="b109475fe2ecbf83596ffe6522bec541"></a><!-- doxytag: member="DOMRange::setStartBefore" ref="b109475fe2ecbf83596ffe6522bec541" args="(const DOMNode *refNode)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::setStartBefore </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>refNode</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the start position to be before a node.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>Range starts before <code>refNode</code> </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, or <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, or <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. <br>
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="5188aa5fcdb9641a5ed8cfd52f5fd324"></a><!-- doxytag: member="DOMRange::setStartAfter" ref="5188aa5fcdb9641a5ed8cfd52f5fd324" args="(const DOMNode *refNode)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::setStartAfter </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>refNode</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the start position to be after a node.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>Range starts after <code>refNode</code> </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, or <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, or <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. <br>
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="136cb62f6bbea91d59e6bf6b2ff9a71b"></a><!-- doxytag: member="DOMRange::setEndBefore" ref="136cb62f6bbea91d59e6bf6b2ff9a71b" args="(const DOMNode *refNode)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::setEndBefore </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>refNode</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the end position to be before a node.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>Range ends before <code>refNode</code> </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, or <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, or <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. <br>
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="ea76fe2447ffeb6866a944b7132b45c7"></a><!-- doxytag: member="DOMRange::setEndAfter" ref="ea76fe2447ffeb6866a944b7132b45c7" args="(const DOMNode *refNode)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::setEndAfter </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>refNode</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the end of a Range to be after a node.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>Range ends after <code>refNode</code>. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not a <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a> or <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, or <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. <br>
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="54ceca8b36504f808f0948ffd8e3e8ac"></a><!-- doxytag: member="DOMRange::collapse" ref="54ceca8b36504f808f0948ffd8e3e8ac" args="(bool toStart)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::collapse </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>toStart</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Collapse a Range onto one of its boundary-points.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>toStart</em> </td><td>If TRUE, collapses the Range onto its start; if FALSE, collapses it onto its end. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="6c7e35df7eb6f376ca77db2cd31cc1c6"></a><!-- doxytag: member="DOMRange::selectNode" ref="6c7e35df7eb6f376ca77db2cd31cc1c6" args="(const DOMNode *refNode)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::selectNode </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>refNode</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Select a node and its contents.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>The node to select. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if an ancestor of <code>refNode</code> is an <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a> or <a class="el" href="classDOMDocumentType.html" title="Each DOMDocument has a doctype attribute whose value is either null or a DOMDocumentType...">DOMDocumentType</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, or <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. <br>
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="a659d982cbaadd0574d564be5659843a"></a><!-- doxytag: member="DOMRange::selectNodeContents" ref="a659d982cbaadd0574d564be5659843a" args="(const DOMNode *refNode)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::selectNodeContents </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>refNode</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Select the contents within a node.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td><a class="el" href="classDOMNode.html" title="The DOMNode interface is the primary datatype for the entire Document Object Model...">DOMNode</a> to select from </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a> or <a class="el" href="classDOMDocumentType.html" title="Each DOMDocument has a doctype attribute whose value is either null or a DOMDocumentType...">DOMDocumentType</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. <br>
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="775c42cb06ad3ff2d88bd101ea56ee99"></a><!-- doxytag: member="DOMRange::compareBoundaryPoints" ref="775c42cb06ad3ff2d88bd101ea56ee99" args="(CompareHow how, const DOMRange *sourceRange) const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual short DOMRange::compareBoundaryPoints </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9">CompareHow</a> </td>
<td class="paramname"> <em>how</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classDOMRange.html">DOMRange</a> * </td>
<td class="paramname"> <em>sourceRange</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Compare the boundary-points of two Ranges in a document.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>how</em> </td><td>A code representing the type of comparison, as defined above. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>sourceRange</em> </td><td>The <code>Range</code> on which this current <code>Range</code> is compared to. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>-1, 0 or 1 depending on whether the corresponding boundary-point of the Range is respectively before, equal to, or after the corresponding boundary-point of <code>sourceRange</code>. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>WRONG_DOCUMENT_ERR: Raised if the two Ranges are not in the same <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a> or <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="f4fb2266db144e548b0da9f9877e684a"></a><!-- doxytag: member="DOMRange::deleteContents" ref="f4fb2266db144e548b0da9f9877e684a" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::deleteContents </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Removes the contents of a Range from the containing document or document fragment without returning a reference to the removed content.
<p>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>NO_MODIFICATION_ALLOWED_ERR: Raised if any portion of the content of the Range is read-only or any of the nodes that contain any of the content of the Range are read-only. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="e45136427cdc1dd1ac4c8580a4fd6b29"></a><!-- doxytag: member="DOMRange::extractContents" ref="e45136427cdc1dd1ac4c8580a4fd6b29" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>* DOMRange::extractContents </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Moves the contents of a Range from the containing document or document fragment to a new <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> containing the extracted contents. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>NO_MODIFICATION_ALLOWED_ERR: Raised if any portion of the content of the Range is read-only or any of the nodes which contain any of the content of the Range are read-only. <br>
HIERARCHY_REQUEST_ERR: Raised if a <a class="el" href="classDOMDocumentType.html" title="Each DOMDocument has a doctype attribute whose value is either null or a DOMDocumentType...">DOMDocumentType</a> node would be extracted into the new <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="7dc35150107908c60499e850b8ee2233"></a><!-- doxytag: member="DOMRange::cloneContents" ref="7dc35150107908c60499e850b8ee2233" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>* DOMRange::cloneContents </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Duplicates the contents of a Range.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> that contains content equivalent to this Range. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>HIERARCHY_REQUEST_ERR: Raised if a <a class="el" href="classDOMDocumentType.html" title="Each DOMDocument has a doctype attribute whose value is either null or a DOMDocumentType...">DOMDocumentType</a> node would be extracted into the new <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a>. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="b23067cbb829d88ffefa610aa4c2a9ee"></a><!-- doxytag: member="DOMRange::insertNode" ref="b23067cbb829d88ffefa610aa4c2a9ee" args="(DOMNode *newNode)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::insertNode </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>newNode</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Inserts a node into the <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a> or <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> at the start of the Range.
<p>
If the container is a <a class="el" href="classDOMText.html" title="The DOMText interface inherits from DOMCharacterData and represents the textual content...">DOMText</a> node, this will be split at the start of the Range (as if the <a class="el" href="classDOMText.html" title="The DOMText interface inherits from DOMCharacterData and represents the textual content...">DOMText</a> node's splitText method was performed at the insertion point) and the insertion will occur between the two resulting <a class="el" href="classDOMText.html" title="The DOMText interface inherits from DOMCharacterData and represents the textual content...">DOMText</a> nodes. Adjacent <a class="el" href="classDOMText.html" title="The DOMText interface inherits from DOMCharacterData and represents the textual content...">DOMText</a> nodes will not be automatically merged. If the node to be inserted is a <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> node, the children will be inserted rather than the <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> node itself. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>newNode</em> </td><td>The node to insert at the start of the Range </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of the start of the Range is read-only. <br>
WRONG_DOCUMENT_ERR: Raised if <code>newNode</code> and the container of the start of the Range were not created from the same document. <br>
HIERARCHY_REQUEST_ERR: Raised if the container of the start of the Range is of a type that does not allow children of the type of <code>newNode</code> or if <code>newNode</code> is an ancestor of the container. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>INVALID_NODE_TYPE_ERR: Raised if <code>newNode</code> is an <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a>, or <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a> node.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="8e064aedbe31b4d6a1e14e1f8209923f"></a><!-- doxytag: member="DOMRange::surroundContents" ref="8e064aedbe31b4d6a1e14e1f8209923f" args="(DOMNode *newParent)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::surroundContents </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classDOMNode.html">DOMNode</a> * </td>
<td class="paramname"> <em>newParent</em> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Reparents the contents of the Range to the given node and inserts the node at the position of the start of the Range.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>newParent</em> </td><td>The node to surround the contents with. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of either boundary-point of the Range is read-only. <br>
WRONG_DOCUMENT_ERR: Raised if <code> newParent</code> and the container of the start of the Range were not created from the same document. <br>
HIERARCHY_REQUEST_ERR: Raised if the container of the start of the Range is of a type that does not allow children of the type of <code>newParent</code> or if <code>newParent</code> is an ancestor of the container or if <code>node</code> would end up with a child node of a type not allowed by the type of <code>node</code>. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMRangeException.html" title="Range operations may throw a DOMRangeException as specified in their method descriptions...">DOMRangeException</a></em> </td><td>BAD_BOUNDARYPOINTS_ERR: Raised if the Range partially selects a non-text node. <br>
INVALID_NODE_TYPE_ERR: Raised if <code> node</code> is an <a class="el" href="classDOMAttr.html" title="The DOMAttr class refers to an attribute of an XML element.">DOMAttr</a>, <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a>, <a class="el" href="classDOMDocumentType.html" title="Each DOMDocument has a doctype attribute whose value is either null or a DOMDocumentType...">DOMDocumentType</a>, <a class="el" href="classDOMNotation.html" title="This interface represents a notation declared in the DTD.">DOMNotation</a>, <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, or <a class="el" href="classDOMDocumentFragment.html" title="DOMDocumentFragment is a "lightweight" or "minimal" DOMDocument...">DOMDocumentFragment</a> node.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="81ccdc2d93423697180c7b98a6019267"></a><!-- doxytag: member="DOMRange::cloneRange" ref="81ccdc2d93423697180c7b98a6019267" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classDOMRange.html">DOMRange</a>* DOMRange::cloneRange </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Produces a new Range whose boundary-points are equal to the boundary-points of the Range.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The duplicated Range. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="110663e653e493c1a6784422e117b1aa"></a><!-- doxytag: member="DOMRange::toString" ref="110663e653e493c1a6784422e117b1aa" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual const <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#fae8f92d83170d97f757f704eca7f52a">XMLCh</a>* DOMRange::toString </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the contents of a Range as a string.
<p>
This string contains only the data characters, not any markup. <dl class="return" compact><dt><b>Returns:</b></dt><dd>The contents of the Range. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="c7b3e797ad3f681f081a07836e369e3a"></a><!-- doxytag: member="DOMRange::detach" ref="c7b3e797ad3f681f081a07836e369e3a" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::detach </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Called to indicate that the Range is no longer in use and that the implementation may relinquish any resources associated with this Range.
<p>
Subsequent calls to any methods or attribute getters on this Range will result in a <code><a class="el" href="classDOMException.html">DOMException</a></code> being thrown with an error code of <code>INVALID_STATE_ERR</code>. <dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classDOMException.html">DOMException</a></em> </td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="9a82e63c7b43806b67b048ff0323cf89"></a><!-- doxytag: member="DOMRange::release" ref="9a82e63c7b43806b67b048ff0323cf89" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void DOMRange::release </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Called to indicate that this Range is no longer in use and that the implementation may relinquish any resources associated with it.
<p>
(<a class="el" href="classDOMRange.html#9a82e63c7b43806b67b048ff0323cf89" title="Called to indicate that this Range is no longer in use and that the implementation...">release()</a> will call <a class="el" href="classDOMRange.html#c7b3e797ad3f681f081a07836e369e3a" title="Called to indicate that the Range is no longer in use and that the implementation...">detach()</a> where appropriate)<p>
Access to a released object will lead to unexpected result.
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="DOMRange_8hpp-source.html">DOMRange.hpp</a></ul>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Fri Jan 29 15:30:48 2010 for Xerces-C++ by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
</body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
contrib-release
>
by-pkgid
>
59e136c5713357bec32fa00e9f43af8f
>
files
>
526
