XQuilla/docs/dom3-api/classxercesc_1_1DOMRange.html
2020-02-17 22:19:08 +01:00

1260 lines
70 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>XQilla DOM3 API Documentation</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<a style="float:right;" href="http://sourceforge.net/projects/xqilla"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=152021&amp;type=2" border="0" alt="SourceForge.net Logo" /></a>
<!-- Generated by Doxygen 1.3.9.1 -->
<div class="qindex"><a class="qindex" href="index.html">Main&nbsp;Page</a> | <a class="qindex" href="namespaces.html">Namespace List</a> | <a class="qindex" href="hierarchy.html">Class&nbsp;Hierarchy</a> | <a class="qindex" href="classes.html">Alphabetical&nbsp;List</a> | <a class="qindex" href="annotated.html">Class&nbsp;List</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File&nbsp;List</a> | <a class="qindex" href="namespacemembers.html">Namespace&nbsp;Members</a> | <a class="qindex" href="functions.html">Class&nbsp;Members</a> | <a class="qindex" href="globals.html">File&nbsp;Members</a> | <a class="qindex" href="examples.html">Examples</a></div>
<h1>xercesc::DOMRange Class Reference</h1><code>#include &lt;<a class="el" href="DOMRange_8hpp-source.html">DOMRange.hpp</a>&gt;</code>
<p>
<a href="classxercesc_1_1DOMRange-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 &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z405_0">CompareHow</a> { <a class="el" href="classxercesc_1_1DOMRange.html#z405_0w0">START_TO_START</a> = 0,
<a class="el" href="classxercesc_1_1DOMRange.html#z405_0w1">START_TO_END</a> = 1,
<a class="el" href="classxercesc_1_1DOMRange.html#z405_0w2">END_TO_END</a> = 2,
<a class="el" href="classxercesc_1_1DOMRange.html#z405_0w3">END_TO_START</a> = 3
}</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Constants CompareHow. <a href="#z405_0">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&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z403_0">~DOMRange</a> ()</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Destructor. <a href="#z403_0"></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="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_0">getStartContainer</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> within which the Range begins. <a href="#z407_0"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual XMLSize_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_1">getStartOffset</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Offset within the starting node of the Range. <a href="#z407_1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_2">getEndContainer</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> within which the Range ends. <a href="#z407_2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual XMLSize_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_3">getEndOffset</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Offset within the ending node of the Range. <a href="#z407_3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_4">getCollapsed</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">TRUE if the Range is collapsed. <a href="#z407_4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_5">getCommonAncestorContainer</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The deepest common ancestor container of the Range's two boundary-points. <a href="#z407_5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_6">setStart</a> (const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *refNode, XMLSize_t offset)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets the attributes describing the start of the Range. <a href="#z407_6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_7">setEnd</a> (const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *refNode, XMLSize_t offset)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets the attributes describing the end of a Range. <a href="#z407_7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_8">setStartBefore</a> (const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets the start position to be before a node. <a href="#z407_8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_9">setStartAfter</a> (const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets the start position to be after a node. <a href="#z407_9"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_10">setEndBefore</a> (const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets the end position to be before a node. <a href="#z407_10"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_11">setEndAfter</a> (const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets the end of a Range to be after a node. <a href="#z407_11"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_12">collapse</a> (bool toStart)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Collapse a Range onto one of its boundary-points. <a href="#z407_12"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_13">selectNode</a> (const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Select a node and its contents. <a href="#z407_13"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_14">selectNodeContents</a> (const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *refNode)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Select the contents within a node. <a href="#z407_14"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual short&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_15">compareBoundaryPoints</a> (<a class="el" href="classxercesc_1_1DOMRange.html#z405_0">CompareHow</a> how, const <a class="el" href="classxercesc_1_1DOMRange.html">DOMRange</a> *sourceRange) const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Compare the boundary-points of two Ranges in a document. <a href="#z407_15"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_16">deleteContents</a> ()=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</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="#z407_16"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_17">extractContents</a> ()=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Moves the contents of a Range from the containing document or document fragment to a new <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>. <a href="#z407_17"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_18">cloneContents</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Duplicates the contents of a Range. <a href="#z407_18"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_19">insertNode</a> (<a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *newNode)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Inserts a node into the <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a> or <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> at the start of the Range. <a href="#z407_19"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_20">surroundContents</a> (<a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *newParent)=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</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="#z407_20"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classxercesc_1_1DOMRange.html">DOMRange</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_21">cloneRange</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Produces a new Range whose boundary-points are equal to the boundary-points of the Range. <a href="#z407_21"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual const XMLCh *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_22">toString</a> () const =0</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the contents of a Range as a string. <a href="#z407_22"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach</a> ()=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</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="#z407_23"></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&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z409_0">release</a> ()=0</td></tr>
<tr><td class="mdescLeft">&nbsp;</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="#z409_0"></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">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z399_0">DOMRange</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classxercesc_1_1DOMRange.html#z399_1">DOMRange</a> (const <a class="el" href="classxercesc_1_1DOMRange.html">DOMRange</a> &amp;)</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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
<p>
<hr><h2>Member Enumeration Documentation</h2>
<a class="anchor" name="z405_0" doxytag="xercesc::DOMRange::CompareHow"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">enum <a class="el" href="classxercesc_1_1DOMRange.html#z405_0">xercesc::DOMRange::CompareHow</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
<dl compact><dt><b>Enumeration values: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" name="z405_0w0" doxytag="START_TO_START"></a>START_TO_START</em>&nbsp;</td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="z405_0w1" doxytag="START_TO_END"></a>START_TO_END</em>&nbsp;</td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="z405_0w2" doxytag="END_TO_END"></a>END_TO_END</em>&nbsp;</td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="z405_0w3" doxytag="END_TO_START"></a>END_TO_START</em>&nbsp;</td><td>
</td></tr>
</table>
</dl>
</td>
</tr>
</table>
<hr><h2>Constructor &amp; Destructor Documentation</h2>
<a class="anchor" name="z399_0" doxytag="xercesc::DOMRange::DOMRange"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">xercesc::DOMRange::DOMRange </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [inline, protected]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="z399_1" doxytag="xercesc::DOMRange::DOMRange"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">xercesc::DOMRange::DOMRange </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMRange.html">DOMRange</a> &amp;&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [inline, protected]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="z403_0" doxytag="xercesc::DOMRange::~DOMRange"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual xercesc::DOMRange::~<a class="el" href="classxercesc_1_1DOMRange.html">DOMRange</a> </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [inline, virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Destructor.
<p>
</td>
</tr>
</table>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="z407_18" doxytag="xercesc::DOMRange::cloneContents"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>* xercesc::DOMRange::cloneContents </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Duplicates the contents of a Range.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">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>DOMException</em>&nbsp;</td><td>HIERARCHY_REQUEST_ERR: Raised if a <a class="el" href="classxercesc_1_1DOMDocumentType.html">DOMDocumentType</a> node would be extracted into the new <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_21" doxytag="xercesc::DOMRange::cloneRange"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual <a class="el" href="classxercesc_1_1DOMRange.html">DOMRange</a>* xercesc::DOMRange::cloneRange </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Produces a new Range whose boundary-points are equal to the boundary-points of the Range.
<p>
<dl 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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_12" doxytag="xercesc::DOMRange::collapse"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::collapse </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">bool&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>toStart</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_15" doxytag="xercesc::DOMRange::compareBoundaryPoints"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual short xercesc::DOMRange::compareBoundaryPoints </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top"><a class="el" href="classxercesc_1_1DOMRange.html#z405_0">CompareHow</a>&nbsp;</td>
<td class="mdname" nowrap> <em>how</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="classxercesc_1_1DOMRange.html">DOMRange</a> *&nbsp;</td>
<td class="mdname" nowrap> <em>sourceRange</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>&nbsp;</td><td>The <code>Range</code> on which this current <code>Range</code> is compared to. </td></tr>
</table>
</dl>
<dl 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>DOMException</em>&nbsp;</td><td>WRONG_DOCUMENT_ERR: Raised if the two Ranges are not in the same <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a> or <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_16" doxytag="xercesc::DOMRange::deleteContents"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::deleteContents </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>DOMException</em>&nbsp;</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="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_23" doxytag="xercesc::DOMRange::detach"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::detach </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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="classxercesc_1_1DOMException.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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_17" doxytag="xercesc::DOMRange::extractContents"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>* xercesc::DOMRange::extractContents </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Moves the contents of a Range from the containing document or document fragment to a new <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">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>DOMException</em>&nbsp;</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="classxercesc_1_1DOMDocumentType.html">DOMDocumentType</a> node would be extracted into the new <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_4" doxytag="xercesc::DOMRange::getCollapsed"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual bool xercesc::DOMRange::getCollapsed </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
TRUE if the Range is collapsed.
<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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_5" doxytag="xercesc::DOMRange::getCommonAncestorContainer"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a>* xercesc::DOMRange::getCommonAncestorContainer </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_2" doxytag="xercesc::DOMRange::getEndContainer"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a>* xercesc::DOMRange::getEndContainer </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
<a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> within which the Range ends.
<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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_3" doxytag="xercesc::DOMRange::getEndOffset"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual XMLSize_t xercesc::DOMRange::getEndOffset </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_0" doxytag="xercesc::DOMRange::getStartContainer"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a>* xercesc::DOMRange::getStartContainer </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
<a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> within which the Range begins.
<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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_1" doxytag="xercesc::DOMRange::getStartOffset"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual XMLSize_t xercesc::DOMRange::getStartOffset </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_19" doxytag="xercesc::DOMRange::insertNode"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::insertNode </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top"><a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>newNode</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Inserts a node into the <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a> or <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> at the start of the Range.
<p>
If the container is a <a class="el" href="classxercesc_1_1DOMText.html">DOMText</a> node, this will be split at the start of the Range (as if the <a class="el" href="classxercesc_1_1DOMText.html">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="classxercesc_1_1DOMText.html">DOMText</a> nodes. Adjacent <a class="el" href="classxercesc_1_1DOMText.html">DOMText</a> nodes will not be automatically merged. If the node to be inserted is a <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> node, the children will be inserted rather than the <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">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>&nbsp;</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>DOMException</em>&nbsp;</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="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if <code>newNode</code> is an <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a>, or <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a> node.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z409_0" doxytag="xercesc::DOMRange::release"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::release </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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="classxercesc_1_1DOMRange.html#z409_0">release()</a> will call <a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a> where appropriate)<p>
Access to a released object will lead to unexpected result. </td>
</tr>
</table>
<a class="anchor" name="z407_13" doxytag="xercesc::DOMRange::selectNode"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::selectNode </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>refNode</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if an ancestor of <code>refNode</code> is an <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a> or <a class="el" href="classxercesc_1_1DOMDocumentType.html">DOMDocumentType</a> node or if <code>refNode</code> is a <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, or <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_14" doxytag="xercesc::DOMRange::selectNodeContents"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::selectNodeContents </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>refNode</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</td><td><a class="el" href="classxercesc_1_1DOMNode.html">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>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a> or <a class="el" href="classxercesc_1_1DOMDocumentType.html">DOMDocumentType</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_7" doxytag="xercesc::DOMRange::setEnd"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::setEnd </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname" nowrap> <em>refNode</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>XMLSize_t&nbsp;</td>
<td class="mdname" nowrap> <em>offset</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>&nbsp;</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>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a>, or <a class="el" href="classxercesc_1_1DOMDocumentType.html">DOMDocumentType</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMException</em>&nbsp;</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="classxercesc_1_1DOMCharacterData.html">DOMCharacterData</a> node (e.g., a <a class="el" href="classxercesc_1_1DOMText.html">DOMText</a> or <a class="el" href="classxercesc_1_1DOMComment.html">DOMComment</a> node) or a <a class="el" href="classxercesc_1_1DOMProcessingInstruction.html">DOMProcessingInstruction</a> node. Child units are Nodes in all other cases. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_11" doxytag="xercesc::DOMRange::setEndAfter"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::setEndAfter </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>refNode</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not a <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a> or <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, or <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_10" doxytag="xercesc::DOMRange::setEndBefore"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::setEndBefore </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>refNode</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, or <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, or <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_6" doxytag="xercesc::DOMRange::setStart"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::setStart </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname" nowrap> <em>refNode</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>XMLSize_t&nbsp;</td>
<td class="mdname" nowrap> <em>offset</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>&nbsp;</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>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a>, or <a class="el" href="classxercesc_1_1DOMDocumentType.html">DOMDocumentType</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMException</em>&nbsp;</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="classxercesc_1_1DOMCharacterData.html">DOMCharacterData</a> node (e.g., a <a class="el" href="classxercesc_1_1DOMText.html">DOMText</a> or <a class="el" href="classxercesc_1_1DOMComment.html">DOMComment</a> node) or a <a class="el" href="classxercesc_1_1DOMProcessingInstruction.html">DOMProcessingInstruction</a> node. Child units are Nodes in all other cases. <br>
INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_9" doxytag="xercesc::DOMRange::setStartAfter"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::setStartAfter </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>refNode</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, or <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, or <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_8" doxytag="xercesc::DOMRange::setStartBefore"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::setStartBefore </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">const <a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>refNode</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>DOMRangeException</em>&nbsp;</td><td>INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, or <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, or <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a> node. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">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 compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_20" doxytag="xercesc::DOMRange::surroundContents"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual void xercesc::DOMRange::surroundContents </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top"><a class="el" href="classxercesc_1_1DOMNode.html">DOMNode</a> *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>newParent</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<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>&nbsp;</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>DOMException</em>&nbsp;</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="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>DOMRangeException</em>&nbsp;</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="classxercesc_1_1DOMAttr.html">DOMAttr</a>, <a class="el" href="classxercesc_1_1DOMEntity.html">DOMEntity</a>, <a class="el" href="classxercesc_1_1DOMDocumentType.html">DOMDocumentType</a>, <a class="el" href="classxercesc_1_1DOMNotation.html">DOMNotation</a>, <a class="el" href="classxercesc_1_1DOMDocument.html">DOMDocument</a>, or <a class="el" href="classxercesc_1_1DOMDocumentFragment.html">DOMDocumentFragment</a> node.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="z407_22" doxytag="xercesc::DOMRange::toString"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual const XMLCh* xercesc::DOMRange::toString </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap> const<code> [pure virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns the contents of a Range as a string.
<p>
This string contains only the data characters, not any markup. <dl 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>DOMException</em>&nbsp;</td><td>INVALID_STATE_ERR: Raised if <code><a class="el" href="classxercesc_1_1DOMRange.html#z407_23">detach()</a></code> has already been invoked on this object.</td></tr>
</table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
</td>
</tr>
</table>
<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>
<hr size="1"><address style="align: right;"><small>Generated on Fri Sep 25 06:55:55 2009 for XQilla DOM Level 3 API by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.3.9.1 </small></address>
</body>
</html>