1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
<title>Xerces-C++: DOMRange Class Reference</title>
4
<link href="doxygen.css" rel="stylesheet" type="text/css">
5
<link href="tabs.css" rel="stylesheet" type="text/css">
7
<!-- Generated by Doxygen 1.5.4 -->
10
<li><a href="index.html"><span>Main Page</span></a></li>
11
<li class="current"><a href="classes.html"><span>Classes</span></a></li>
12
<li><a href="files.html"><span>Files</span></a></li>
13
<li><a href="pages.html"><span>Related Pages</span></a></li>
18
<li><a href="classes.html"><span>Alphabetical List</span></a></li>
19
<li><a href="annotated.html"><span>Class List</span></a></li>
20
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
21
<li><a href="functions.html"><span>Class Members</span></a></li>
24
<h1>DOMRange Class Reference</h1><!-- doxytag: class="DOMRange" -->
26
<a href="classDOMRange-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
28
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
29
<tr><td colspan="2"><div class="groupHeader">Public Contants</div></td></tr>
30
<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,
31
<a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9a002ea522f96d72c9c99f86269e9176a">START_TO_END</a> = 1,
32
<a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9af3b7f157d490024baf1b7b4736db134">END_TO_END</a> = 2,
33
<a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9e8f27dbcc33d9113cc55bc4b4255b287">END_TO_START</a> = 3
36
<tr><td class="mdescLeft"> </td><td class="mdescRight">Constants CompareHow. <a href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9">More...</a><br></td></tr>
37
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
38
<tr><td colspan="2"><div class="groupHeader">Destructor</div></td></tr>
39
<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>
41
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#fc4bac82009e31a64a9cb892769f241b"></a><br></td></tr>
42
<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 2</div></td></tr>
43
<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>
45
<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>
46
<table border="0" cellspacing="2" cellpadding="0">
47
<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>
50
<a href="#f4db1a7e3566b625edc162a281e735d2"></a><br></td></tr>
51
<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>
53
<tr><td class="mdescLeft"> </td><td class="mdescRight">Offset within the starting node of the Range. <a href="#3f1f2dccaefcc2686c3c527a82f5f0fd"></a><br></td></tr>
54
<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>
56
<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>
57
<table border="0" cellspacing="2" cellpadding="0">
58
<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>
61
<a href="#1be5b6cb356ca847a8e1eb5a9131c4ed"></a><br></td></tr>
62
<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>
64
<tr><td class="mdescLeft"> </td><td class="mdescRight">Offset within the ending node of the Range. <a href="#cafa27c9b763b71951088a545111c84b"></a><br></td></tr>
65
<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>
67
<tr><td class="mdescLeft"> </td><td class="mdescRight">TRUE if the Range is collapsed <dl compact><dt><b>Exceptions:</b></dt><dd>
68
<table border="0" cellspacing="2" cellpadding="0">
69
<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>
72
<a href="#654c1d89653bd03d39c6891130a0ee99"></a><br></td></tr>
73
<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>
75
<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>
76
<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>
78
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the attributes describing the start of the Range. <a href="#f25ec2bf59cbc16925c8e1931c953b33"></a><br></td></tr>
79
<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>
81
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the attributes describing the end of a Range. <a href="#fd237c4bb732ccac0d04c4a85128ec6e"></a><br></td></tr>
82
<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>
84
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the start position to be before a node. <a href="#b109475fe2ecbf83596ffe6522bec541"></a><br></td></tr>
85
<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>
87
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the start position to be after a node. <a href="#5188aa5fcdb9641a5ed8cfd52f5fd324"></a><br></td></tr>
88
<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>
90
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the end position to be before a node. <a href="#136cb62f6bbea91d59e6bf6b2ff9a71b"></a><br></td></tr>
91
<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>
93
<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>
94
<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>
96
<tr><td class="mdescLeft"> </td><td class="mdescRight">Collapse a Range onto one of its boundary-points. <a href="#54ceca8b36504f808f0948ffd8e3e8ac"></a><br></td></tr>
97
<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>
99
<tr><td class="mdescLeft"> </td><td class="mdescRight">Select a node and its contents. <a href="#6c7e35df7eb6f376ca77db2cd31cc1c6"></a><br></td></tr>
100
<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>
102
<tr><td class="mdescLeft"> </td><td class="mdescRight">Select the contents within a node. <a href="#a659d982cbaadd0574d564be5659843a"></a><br></td></tr>
103
<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>
105
<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>
106
<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>
108
<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>
109
<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>
111
<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>
112
<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>
114
<tr><td class="mdescLeft"> </td><td class="mdescRight">Duplicates the contents of a Range. <a href="#7dc35150107908c60499e850b8ee2233"></a><br></td></tr>
115
<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>
117
<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>
118
<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>
120
<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>
121
<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>
123
<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>
124
<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>
126
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the contents of a Range as a string. <a href="#110663e653e493c1a6784422e117b1aa"></a><br></td></tr>
127
<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>
129
<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>
130
<tr><td colspan="2"><div class="groupHeader">Non-standard Extension</div></td></tr>
131
<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>
133
<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>
134
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
135
<tr><td colspan="2"><div class="groupHeader">Hidden constructors</div></td></tr>
136
<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>
138
<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>
141
<hr><a name="_details"></a><h2>Detailed Description</h2>
142
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>
143
<hr><h2>Member Enumeration Documentation</h2>
144
<a class="anchor" name="1459ada3b7cbdd517b4104fa8a8af0a9"></a><!-- doxytag: member="DOMRange::CompareHow" ref="1459ada3b7cbdd517b4104fa8a8af0a9" args="" -->
145
<div class="memitem">
146
<div class="memproto">
147
<table class="memname">
149
<td class="memname">enum <a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9">DOMRange::CompareHow</a> </td>
156
Constants CompareHow.
158
<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>
159
<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>
160
<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>
161
<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>
162
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
163
<dl compact><dt><b>Enumerator: </b></dt><dd>
164
<table border="0" cellspacing="2" cellpadding="0">
165
<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>
167
<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>
169
<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>
171
<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>
178
<hr><h2>Constructor & Destructor Documentation</h2>
179
<a class="anchor" name="6e6606503a2023af378a32c90be021bf"></a><!-- doxytag: member="DOMRange::DOMRange" ref="6e6606503a2023af378a32c90be021bf" args="()" -->
180
<div class="memitem">
181
<div class="memproto">
182
<table class="memname">
184
<td class="memname">DOMRange::DOMRange </td>
186
<td class="paramname"> </td>
187
<td> ) </td>
188
<td width="100%"><code> [protected]</code></td>
198
<a class="anchor" name="f8ec07eb322835f364d18ce0836c98d8"></a><!-- doxytag: member="DOMRange::DOMRange" ref="f8ec07eb322835f364d18ce0836c98d8" args="(const DOMRange &)" -->
199
<div class="memitem">
200
<div class="memproto">
201
<table class="memname">
203
<td class="memname">DOMRange::DOMRange </td>
205
<td class="paramtype">const <a class="el" href="classDOMRange.html">DOMRange</a> & </td>
206
<td class="paramname"> </td>
207
<td> ) </td>
208
<td width="100%"><code> [protected]</code></td>
218
<a class="anchor" name="fc4bac82009e31a64a9cb892769f241b"></a><!-- doxytag: member="DOMRange::~DOMRange" ref="fc4bac82009e31a64a9cb892769f241b" args="()" -->
219
<div class="memitem">
220
<div class="memproto">
221
<table class="memname">
223
<td class="memname">virtual DOMRange::~DOMRange </td>
225
<td class="paramname"> </td>
226
<td> ) </td>
227
<td width="100%"><code> [virtual]</code></td>
239
<hr><h2>Member Function Documentation</h2>
240
<a class="anchor" name="f4db1a7e3566b625edc162a281e735d2"></a><!-- doxytag: member="DOMRange::getStartContainer" ref="f4db1a7e3566b625edc162a281e735d2" args="() const =0" -->
241
<div class="memitem">
242
<div class="memproto">
243
<table class="memname">
245
<td class="memname">virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getStartContainer </td>
247
<td class="paramname"> </td>
248
<td> ) </td>
249
<td width="100%"> const<code> [pure virtual]</code></td>
256
<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>
257
<table border="0" cellspacing="2" cellpadding="0">
258
<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>
263
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
267
<a class="anchor" name="3f1f2dccaefcc2686c3c527a82f5f0fd"></a><!-- doxytag: member="DOMRange::getStartOffset" ref="3f1f2dccaefcc2686c3c527a82f5f0fd" args="() const =0" -->
268
<div class="memitem">
269
<div class="memproto">
270
<table class="memname">
272
<td class="memname">virtual <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> DOMRange::getStartOffset </td>
274
<td class="paramname"> </td>
275
<td> ) </td>
276
<td width="100%"> const<code> [pure virtual]</code></td>
283
Offset within the starting node of the Range.
285
<dl compact><dt><b>Exceptions:</b></dt><dd>
286
<table border="0" cellspacing="2" cellpadding="0">
287
<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>
290
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
294
<a class="anchor" name="1be5b6cb356ca847a8e1eb5a9131c4ed"></a><!-- doxytag: member="DOMRange::getEndContainer" ref="1be5b6cb356ca847a8e1eb5a9131c4ed" args="() const =0" -->
295
<div class="memitem">
296
<div class="memproto">
297
<table class="memname">
299
<td class="memname">virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getEndContainer </td>
301
<td class="paramname"> </td>
302
<td> ) </td>
303
<td width="100%"> const<code> [pure virtual]</code></td>
310
<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>
311
<table border="0" cellspacing="2" cellpadding="0">
312
<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>
317
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
321
<a class="anchor" name="cafa27c9b763b71951088a545111c84b"></a><!-- doxytag: member="DOMRange::getEndOffset" ref="cafa27c9b763b71951088a545111c84b" args="() const =0" -->
322
<div class="memitem">
323
<div class="memproto">
324
<table class="memname">
326
<td class="memname">virtual <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> DOMRange::getEndOffset </td>
328
<td class="paramname"> </td>
329
<td> ) </td>
330
<td width="100%"> const<code> [pure virtual]</code></td>
337
Offset within the ending node of the Range.
339
<dl compact><dt><b>Exceptions:</b></dt><dd>
340
<table border="0" cellspacing="2" cellpadding="0">
341
<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>
344
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
348
<a class="anchor" name="654c1d89653bd03d39c6891130a0ee99"></a><!-- doxytag: member="DOMRange::getCollapsed" ref="654c1d89653bd03d39c6891130a0ee99" args="() const =0" -->
349
<div class="memitem">
350
<div class="memproto">
351
<table class="memname">
353
<td class="memname">virtual bool DOMRange::getCollapsed </td>
355
<td class="paramname"> </td>
356
<td> ) </td>
357
<td width="100%"> const<code> [pure virtual]</code></td>
364
TRUE if the Range is collapsed <dl compact><dt><b>Exceptions:</b></dt><dd>
365
<table border="0" cellspacing="2" cellpadding="0">
366
<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>
371
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
375
<a class="anchor" name="1e978223e6dce5643f6dd4489c5ef286"></a><!-- doxytag: member="DOMRange::getCommonAncestorContainer" ref="1e978223e6dce5643f6dd4489c5ef286" args="() const =0" -->
376
<div class="memitem">
377
<div class="memproto">
378
<table class="memname">
380
<td class="memname">virtual const <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getCommonAncestorContainer </td>
382
<td class="paramname"> </td>
383
<td> ) </td>
384
<td width="100%"> const<code> [pure virtual]</code></td>
391
The deepest common ancestor container of the Range's two boundary-points.
393
<dl compact><dt><b>Exceptions:</b></dt><dd>
394
<table border="0" cellspacing="2" cellpadding="0">
395
<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>
398
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
402
<a class="anchor" name="f25ec2bf59cbc16925c8e1931c953b33"></a><!-- doxytag: member="DOMRange::setStart" ref="f25ec2bf59cbc16925c8e1931c953b33" args="(const DOMNode *refNode, XMLSize_t offset)=0" -->
403
<div class="memitem">
404
<div class="memproto">
405
<table class="memname">
407
<td class="memname">virtual void DOMRange::setStart </td>
409
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
410
<td class="paramname"> <em>refNode</em>, </td>
413
<td class="paramkey"></td>
415
<td class="paramtype"><a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> </td>
416
<td class="paramname"> <em>offset</em></td><td> </td>
421
<td></td><td></td><td width="100%"><code> [pure virtual]</code></td>
428
Sets the attributes describing the start of the Range.
430
<dl compact><dt><b>Parameters:</b></dt><dd>
431
<table border="0" cellspacing="2" cellpadding="0">
432
<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>
433
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The <code>startOffset</code> value. </td></tr>
436
<dl compact><dt><b>Exceptions:</b></dt><dd>
437
<table border="0" cellspacing="2" cellpadding="0">
438
<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>
439
<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>
440
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>
441
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
444
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
448
<a class="anchor" name="fd237c4bb732ccac0d04c4a85128ec6e"></a><!-- doxytag: member="DOMRange::setEnd" ref="fd237c4bb732ccac0d04c4a85128ec6e" args="(const DOMNode *refNode, XMLSize_t offset)=0" -->
449
<div class="memitem">
450
<div class="memproto">
451
<table class="memname">
453
<td class="memname">virtual void DOMRange::setEnd </td>
455
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
456
<td class="paramname"> <em>refNode</em>, </td>
459
<td class="paramkey"></td>
461
<td class="paramtype"><a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#c0f7e36996cd03eb43bcee10321f77cd">XMLSize_t</a> </td>
462
<td class="paramname"> <em>offset</em></td><td> </td>
467
<td></td><td></td><td width="100%"><code> [pure virtual]</code></td>
474
Sets the attributes describing the end of a Range.
476
<dl compact><dt><b>Parameters:</b></dt><dd>
477
<table border="0" cellspacing="2" cellpadding="0">
478
<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>
479
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The <code>endOffset</code> value. </td></tr>
482
<dl compact><dt><b>Exceptions:</b></dt><dd>
483
<table border="0" cellspacing="2" cellpadding="0">
484
<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>
485
<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>
486
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>
487
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
490
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
494
<a class="anchor" name="b109475fe2ecbf83596ffe6522bec541"></a><!-- doxytag: member="DOMRange::setStartBefore" ref="b109475fe2ecbf83596ffe6522bec541" args="(const DOMNode *refNode)=0" -->
495
<div class="memitem">
496
<div class="memproto">
497
<table class="memname">
499
<td class="memname">virtual void DOMRange::setStartBefore </td>
501
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
502
<td class="paramname"> <em>refNode</em> </td>
503
<td> ) </td>
504
<td width="100%"><code> [pure virtual]</code></td>
511
Sets the start position to be before a node.
513
<dl compact><dt><b>Parameters:</b></dt><dd>
514
<table border="0" cellspacing="2" cellpadding="0">
515
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>Range starts before <code>refNode</code> </td></tr>
518
<dl compact><dt><b>Exceptions:</b></dt><dd>
519
<table border="0" cellspacing="2" cellpadding="0">
520
<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>
521
<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>
522
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
525
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
529
<a class="anchor" name="5188aa5fcdb9641a5ed8cfd52f5fd324"></a><!-- doxytag: member="DOMRange::setStartAfter" ref="5188aa5fcdb9641a5ed8cfd52f5fd324" args="(const DOMNode *refNode)=0" -->
530
<div class="memitem">
531
<div class="memproto">
532
<table class="memname">
534
<td class="memname">virtual void DOMRange::setStartAfter </td>
536
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
537
<td class="paramname"> <em>refNode</em> </td>
538
<td> ) </td>
539
<td width="100%"><code> [pure virtual]</code></td>
546
Sets the start position to be after a node.
548
<dl compact><dt><b>Parameters:</b></dt><dd>
549
<table border="0" cellspacing="2" cellpadding="0">
550
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>Range starts after <code>refNode</code> </td></tr>
553
<dl compact><dt><b>Exceptions:</b></dt><dd>
554
<table border="0" cellspacing="2" cellpadding="0">
555
<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>
556
<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>
557
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
560
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
564
<a class="anchor" name="136cb62f6bbea91d59e6bf6b2ff9a71b"></a><!-- doxytag: member="DOMRange::setEndBefore" ref="136cb62f6bbea91d59e6bf6b2ff9a71b" args="(const DOMNode *refNode)=0" -->
565
<div class="memitem">
566
<div class="memproto">
567
<table class="memname">
569
<td class="memname">virtual void DOMRange::setEndBefore </td>
571
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
572
<td class="paramname"> <em>refNode</em> </td>
573
<td> ) </td>
574
<td width="100%"><code> [pure virtual]</code></td>
581
Sets the end position to be before a node.
583
<dl compact><dt><b>Parameters:</b></dt><dd>
584
<table border="0" cellspacing="2" cellpadding="0">
585
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>Range ends before <code>refNode</code> </td></tr>
588
<dl compact><dt><b>Exceptions:</b></dt><dd>
589
<table border="0" cellspacing="2" cellpadding="0">
590
<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>
591
<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>
592
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
595
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
599
<a class="anchor" name="ea76fe2447ffeb6866a944b7132b45c7"></a><!-- doxytag: member="DOMRange::setEndAfter" ref="ea76fe2447ffeb6866a944b7132b45c7" args="(const DOMNode *refNode)=0" -->
600
<div class="memitem">
601
<div class="memproto">
602
<table class="memname">
604
<td class="memname">virtual void DOMRange::setEndAfter </td>
606
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
607
<td class="paramname"> <em>refNode</em> </td>
608
<td> ) </td>
609
<td width="100%"><code> [pure virtual]</code></td>
616
Sets the end of a Range to be after a node.
618
<dl compact><dt><b>Parameters:</b></dt><dd>
619
<table border="0" cellspacing="2" cellpadding="0">
620
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>Range ends after <code>refNode</code>. </td></tr>
623
<dl compact><dt><b>Exceptions:</b></dt><dd>
624
<table border="0" cellspacing="2" cellpadding="0">
625
<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>
626
<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>
627
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
630
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
634
<a class="anchor" name="54ceca8b36504f808f0948ffd8e3e8ac"></a><!-- doxytag: member="DOMRange::collapse" ref="54ceca8b36504f808f0948ffd8e3e8ac" args="(bool toStart)=0" -->
635
<div class="memitem">
636
<div class="memproto">
637
<table class="memname">
639
<td class="memname">virtual void DOMRange::collapse </td>
641
<td class="paramtype">bool </td>
642
<td class="paramname"> <em>toStart</em> </td>
643
<td> ) </td>
644
<td width="100%"><code> [pure virtual]</code></td>
651
Collapse a Range onto one of its boundary-points.
653
<dl compact><dt><b>Parameters:</b></dt><dd>
654
<table border="0" cellspacing="2" cellpadding="0">
655
<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>
658
<dl compact><dt><b>Exceptions:</b></dt><dd>
659
<table border="0" cellspacing="2" cellpadding="0">
660
<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>
663
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
667
<a class="anchor" name="6c7e35df7eb6f376ca77db2cd31cc1c6"></a><!-- doxytag: member="DOMRange::selectNode" ref="6c7e35df7eb6f376ca77db2cd31cc1c6" args="(const DOMNode *refNode)=0" -->
668
<div class="memitem">
669
<div class="memproto">
670
<table class="memname">
672
<td class="memname">virtual void DOMRange::selectNode </td>
674
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
675
<td class="paramname"> <em>refNode</em> </td>
676
<td> ) </td>
677
<td width="100%"><code> [pure virtual]</code></td>
684
Select a node and its contents.
686
<dl compact><dt><b>Parameters:</b></dt><dd>
687
<table border="0" cellspacing="2" cellpadding="0">
688
<tr><td valign="top"></td><td valign="top"><em>refNode</em> </td><td>The node to select. </td></tr>
691
<dl compact><dt><b>Exceptions:</b></dt><dd>
692
<table border="0" cellspacing="2" cellpadding="0">
693
<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>
694
<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>
695
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
698
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
702
<a class="anchor" name="a659d982cbaadd0574d564be5659843a"></a><!-- doxytag: member="DOMRange::selectNodeContents" ref="a659d982cbaadd0574d564be5659843a" args="(const DOMNode *refNode)=0" -->
703
<div class="memitem">
704
<div class="memproto">
705
<table class="memname">
707
<td class="memname">virtual void DOMRange::selectNodeContents </td>
709
<td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> * </td>
710
<td class="paramname"> <em>refNode</em> </td>
711
<td> ) </td>
712
<td width="100%"><code> [pure virtual]</code></td>
719
Select the contents within a node.
721
<dl compact><dt><b>Parameters:</b></dt><dd>
722
<table border="0" cellspacing="2" cellpadding="0">
723
<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>
726
<dl compact><dt><b>Exceptions:</b></dt><dd>
727
<table border="0" cellspacing="2" cellpadding="0">
728
<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>
729
<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>
730
WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
733
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
737
<a class="anchor" name="775c42cb06ad3ff2d88bd101ea56ee99"></a><!-- doxytag: member="DOMRange::compareBoundaryPoints" ref="775c42cb06ad3ff2d88bd101ea56ee99" args="(CompareHow how, const DOMRange *sourceRange) const =0" -->
738
<div class="memitem">
739
<div class="memproto">
740
<table class="memname">
742
<td class="memname">virtual short DOMRange::compareBoundaryPoints </td>
744
<td class="paramtype"><a class="el" href="classDOMRange.html#1459ada3b7cbdd517b4104fa8a8af0a9">CompareHow</a> </td>
745
<td class="paramname"> <em>how</em>, </td>
748
<td class="paramkey"></td>
750
<td class="paramtype">const <a class="el" href="classDOMRange.html">DOMRange</a> * </td>
751
<td class="paramname"> <em>sourceRange</em></td><td> </td>
756
<td></td><td></td><td width="100%"> const<code> [pure virtual]</code></td>
763
Compare the boundary-points of two Ranges in a document.
765
<dl compact><dt><b>Parameters:</b></dt><dd>
766
<table border="0" cellspacing="2" cellpadding="0">
767
<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>
768
<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>
771
<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>
772
<dl compact><dt><b>Exceptions:</b></dt><dd>
773
<table border="0" cellspacing="2" cellpadding="0">
774
<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>
775
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>
778
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
782
<a class="anchor" name="f4fb2266db144e548b0da9f9877e684a"></a><!-- doxytag: member="DOMRange::deleteContents" ref="f4fb2266db144e548b0da9f9877e684a" args="()=0" -->
783
<div class="memitem">
784
<div class="memproto">
785
<table class="memname">
787
<td class="memname">virtual void DOMRange::deleteContents </td>
789
<td class="paramname"> </td>
790
<td> ) </td>
791
<td width="100%"><code> [pure virtual]</code></td>
798
Removes the contents of a Range from the containing document or document fragment without returning a reference to the removed content.
800
<dl compact><dt><b>Exceptions:</b></dt><dd>
801
<table border="0" cellspacing="2" cellpadding="0">
802
<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>
803
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>
806
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
810
<a class="anchor" name="e45136427cdc1dd1ac4c8580a4fd6b29"></a><!-- doxytag: member="DOMRange::extractContents" ref="e45136427cdc1dd1ac4c8580a4fd6b29" args="()=0" -->
811
<div class="memitem">
812
<div class="memproto">
813
<table class="memname">
815
<td class="memname">virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>* DOMRange::extractContents </td>
817
<td class="paramname"> </td>
818
<td> ) </td>
819
<td width="100%"><code> [pure virtual]</code></td>
826
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>.
828
<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>
829
<dl compact><dt><b>Exceptions:</b></dt><dd>
830
<table border="0" cellspacing="2" cellpadding="0">
831
<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>
832
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>
833
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>
836
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
840
<a class="anchor" name="7dc35150107908c60499e850b8ee2233"></a><!-- doxytag: member="DOMRange::cloneContents" ref="7dc35150107908c60499e850b8ee2233" args="() const =0" -->
841
<div class="memitem">
842
<div class="memproto">
843
<table class="memname">
845
<td class="memname">virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>* DOMRange::cloneContents </td>
847
<td class="paramname"> </td>
848
<td> ) </td>
849
<td width="100%"> const<code> [pure virtual]</code></td>
856
Duplicates the contents of a Range.
858
<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>
859
<dl compact><dt><b>Exceptions:</b></dt><dd>
860
<table border="0" cellspacing="2" cellpadding="0">
861
<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>
862
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>
865
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
869
<a class="anchor" name="b23067cbb829d88ffefa610aa4c2a9ee"></a><!-- doxytag: member="DOMRange::insertNode" ref="b23067cbb829d88ffefa610aa4c2a9ee" args="(DOMNode *newNode)=0" -->
870
<div class="memitem">
871
<div class="memproto">
872
<table class="memname">
874
<td class="memname">virtual void DOMRange::insertNode </td>
876
<td class="paramtype"><a class="el" href="classDOMNode.html">DOMNode</a> * </td>
877
<td class="paramname"> <em>newNode</em> </td>
878
<td> ) </td>
879
<td width="100%"><code> [pure virtual]</code></td>
886
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.
888
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>
889
<table border="0" cellspacing="2" cellpadding="0">
890
<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>
893
<dl compact><dt><b>Exceptions:</b></dt><dd>
894
<table border="0" cellspacing="2" cellpadding="0">
895
<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>
896
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>
897
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>
898
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>
899
<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>
902
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
906
<a class="anchor" name="8e064aedbe31b4d6a1e14e1f8209923f"></a><!-- doxytag: member="DOMRange::surroundContents" ref="8e064aedbe31b4d6a1e14e1f8209923f" args="(DOMNode *newParent)=0" -->
907
<div class="memitem">
908
<div class="memproto">
909
<table class="memname">
911
<td class="memname">virtual void DOMRange::surroundContents </td>
913
<td class="paramtype"><a class="el" href="classDOMNode.html">DOMNode</a> * </td>
914
<td class="paramname"> <em>newParent</em> </td>
915
<td> ) </td>
916
<td width="100%"><code> [pure virtual]</code></td>
923
Reparents the contents of the Range to the given node and inserts the node at the position of the start of the Range.
925
<dl compact><dt><b>Parameters:</b></dt><dd>
926
<table border="0" cellspacing="2" cellpadding="0">
927
<tr><td valign="top"></td><td valign="top"><em>newParent</em> </td><td>The node to surround the contents with. </td></tr>
930
<dl compact><dt><b>Exceptions:</b></dt><dd>
931
<table border="0" cellspacing="2" cellpadding="0">
932
<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>
933
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>
934
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>
935
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>
936
<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>
937
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>
940
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
944
<a class="anchor" name="81ccdc2d93423697180c7b98a6019267"></a><!-- doxytag: member="DOMRange::cloneRange" ref="81ccdc2d93423697180c7b98a6019267" args="() const =0" -->
945
<div class="memitem">
946
<div class="memproto">
947
<table class="memname">
949
<td class="memname">virtual <a class="el" href="classDOMRange.html">DOMRange</a>* DOMRange::cloneRange </td>
951
<td class="paramname"> </td>
952
<td> ) </td>
953
<td width="100%"> const<code> [pure virtual]</code></td>
960
Produces a new Range whose boundary-points are equal to the boundary-points of the Range.
962
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The duplicated Range. </dd></dl>
963
<dl compact><dt><b>Exceptions:</b></dt><dd>
964
<table border="0" cellspacing="2" cellpadding="0">
965
<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>
968
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
972
<a class="anchor" name="110663e653e493c1a6784422e117b1aa"></a><!-- doxytag: member="DOMRange::toString" ref="110663e653e493c1a6784422e117b1aa" args="() const =0" -->
973
<div class="memitem">
974
<div class="memproto">
975
<table class="memname">
977
<td class="memname">virtual const <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#fae8f92d83170d97f757f704eca7f52a">XMLCh</a>* DOMRange::toString </td>
979
<td class="paramname"> </td>
980
<td> ) </td>
981
<td width="100%"> const<code> [pure virtual]</code></td>
988
Returns the contents of a Range as a string.
990
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>
991
<dl compact><dt><b>Exceptions:</b></dt><dd>
992
<table border="0" cellspacing="2" cellpadding="0">
993
<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>
996
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
1000
<a class="anchor" name="c7b3e797ad3f681f081a07836e369e3a"></a><!-- doxytag: member="DOMRange::detach" ref="c7b3e797ad3f681f081a07836e369e3a" args="()=0" -->
1001
<div class="memitem">
1002
<div class="memproto">
1003
<table class="memname">
1005
<td class="memname">virtual void DOMRange::detach </td>
1007
<td class="paramname"> </td>
1008
<td> ) </td>
1009
<td width="100%"><code> [pure virtual]</code></td>
1013
<div class="memdoc">
1016
Called to indicate that the Range is no longer in use and that the implementation may relinquish any resources associated with this Range.
1018
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>
1019
<table border="0" cellspacing="2" cellpadding="0">
1020
<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>
1023
<dl class="since" compact><dt><b>Since:</b></dt><dd>DOM Level 2 </dd></dl>
1027
<a class="anchor" name="9a82e63c7b43806b67b048ff0323cf89"></a><!-- doxytag: member="DOMRange::release" ref="9a82e63c7b43806b67b048ff0323cf89" args="()=0" -->
1028
<div class="memitem">
1029
<div class="memproto">
1030
<table class="memname">
1032
<td class="memname">virtual void DOMRange::release </td>
1034
<td class="paramname"> </td>
1035
<td> ) </td>
1036
<td width="100%"><code> [pure virtual]</code></td>
1040
<div class="memdoc">
1043
Called to indicate that this Range is no longer in use and that the implementation may relinquish any resources associated with it.
1045
(<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>
1046
Access to a released object will lead to unexpected result.
1049
<hr>The documentation for this class was generated from the following file:<ul>
1050
<li><a class="el" href="DOMRange_8hpp-source.html">DOMRange.hpp</a></ul>
1051
<hr size="1"><address style="text-align: right;"><small>Generated on Wed Feb 18 07:56:11 2009 for Xerces-C++ by
1052
<a href="http://www.doxygen.org/index.html">
1053
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.4 </small></address>