source: NonGTP/Xerces/xerces/doc/html/apiDocs/classDOMRange.html @ 358

Revision 358, 74.9 KB checked in by bittner, 19 years ago (diff)

xerces added
Line 
1<HTML><HEAD><SCRIPT language="JavaScript" src="../resources/script.js" type="text/javascript"></SCRIPT><TITLE>DOMRange class Reference</TITLE><link href="XercesApi.css" rel="stylesheet" type="text/css"></HEAD><BODY alink="#ff0000" bgcolor="#ffffff" leftmargin="4" link="#0000ff" marginheight="4" marginwidth="4" text="#000000" topmargin="4" vlink="#0000aa"><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" height="60" rowspan="3" valign="top" width="135"><IMG border="0" height="60" hspace="0" src="../resources/logo.gif" vspace="0" width="135"></TD><TD align="left" colspan="4" height="5" valign="top" width="456"><IMG border="0" height="5" hspace="0" src="../resources/line.gif" vspace="0" width="456"></TD><TD align="left" height="60" rowspan="3" valign="top" width="29"><IMG border="0" height="60" hspace="0" src="../resources/right.gif" vspace="0" width="29"></TD></TR><TR><TD align="left" bgcolor="#0086b2" colspan="4" height="35" valign="top" width="456"><IMG alt="" border="0" height="35" hspace="0" src="../graphics/api-header.jpg" vspace="0" width="456"></TD></TR><TR><TD align="left" height="20" valign="top" width="168"><IMG border="0" height="20" hspace="0" src="../resources/bottom.gif" vspace="0" width="168"></TD><TD align="left" height="20" valign="top" width="96"><A href="http://xml.apache.org/" onMouseOut="rolloverOff('xml');" onMouseOver="rolloverOn('xml');" target="new"><IMG alt="http://xml.apache.org/" border="0" height="20" hspace="0" name="xml" onLoad="rolloverLoad('xml','../resources/button-xml-hi.gif','../resources/button-xml-lo.gif');" src="../resources/button-xml-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.apache.org/" onMouseOut="rolloverOff('asf');" onMouseOver="rolloverOn('asf');" target="new"><IMG alt="http://www.apache.org/" border="0" height="20" hspace="0" name="asf" onLoad="rolloverLoad('asf','../resources/button-asf-hi.gif','../resources/button-asf-lo.gif');" src="../resources/button-asf-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.w3.org/" onMouseOut="rolloverOff('w3c');" onMouseOver="rolloverOn('w3c');" target="new"><IMG alt="http://www.w3.org/" border="0" height="20" hspace="0" name="w3c" onLoad="rolloverLoad('w3c','../resources/button-w3c-hi.gif','../resources/button-w3c-lo.gif');" src="../resources/button-w3c-lo.gif" vspace="0" width="96"></A></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" valign="top" width="120"><IMG border="0" height="14" hspace="0" src="../resources/join.gif" vspace="0" width="120"><BR>
2  <A href="../../index.html" onMouseOut="rolloverOff('side-ext-2');" onMouseOver="rolloverOn('side-ext-2');"><IMG alt="Home" border="0" height="12" hspace="0" name="side-ext-2" onLoad="rolloverLoad('side-ext-2','../graphics/ext-2-label-2.jpg','../graphics/ext-2-label-3.jpg');" src="../graphics/ext-2-label-3.jpg" vspace="0" width="120"></A><BR>
3
4  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
5
6  <A href="../index.html" onMouseOut="rolloverOff('side-index');" onMouseOver="rolloverOn('side-index');"><IMG alt="Readme" border="0" height="12" hspace="0" name="side-index" onLoad="rolloverLoad('side-index','../graphics/index-label-2.jpg','../graphics/index-label-3.jpg');" src="../graphics/index-label-3.jpg" vspace="0" width="120"></A><BR>
7  <A href="../releases.html" onMouseOut="rolloverOff('side-releases');" onMouseOver="rolloverOn('side-releases');"><IMG alt="Release Info" border="0" height="12" hspace="0" name="side-releases" onLoad="rolloverLoad('side-releases','../graphics/releases-label-2.jpg','../graphics/releases-label-3.jpg');" src="../graphics/releases-label-3.jpg" vspace="0" width="120"></A><BR>
8  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
9  <A href="../install.html" onMouseOut="rolloverOff('side-install');" onMouseOver="rolloverOn('side-install');"><IMG alt="Installation" border="0" height="12" hspace="0" name="side-install" onLoad="rolloverLoad('side-install','../graphics/install-label-2.jpg','../graphics/install-label-3.jpg');" src="../graphics/install-label-3.jpg" vspace="0" width="120"></A><BR>
10  <A href="http://xml.apache.org/dist/xerces-c/" onMouseOut="rolloverOff('side-ext-18');" onMouseOver="rolloverOn('side-ext-18');"><IMG alt="Download" border="0" height="12" hspace="0" name="side-ext-18" onLoad="rolloverLoad('side-ext-18','../graphics/ext-18-label-2.jpg','../graphics/ext-18-label-3.jpg');" src="../graphics/ext-18-label-3.jpg" vspace="0" width="120"></A><BR>
11  <A href="../build.html" onMouseOut="rolloverOff('side-build');" onMouseOver="rolloverOn('side-build');"><IMG alt="Build" border="0" height="12" hspace="0" name="side-build" onLoad="rolloverLoad('side-build','../graphics/build-label-2.jpg','../graphics/build-label-3.jpg');" src="../graphics/build-label-3.jpg" vspace="0" width="120"></A><BR>
12
13  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
14  <A href="../faqs.html" onMouseOut="rolloverOff('side-faqs');" onMouseOver="rolloverOn('side-faqs');"><IMG alt="FAQs" border="0" height="12" hspace="0" name="side-faqs" onLoad="rolloverLoad('side-faqs','../graphics/faqs-label-2.jpg','../graphics/faqs-label-3.jpg');" src="../graphics/faqs-label-3.jpg" vspace="0" width="120"></A><BR> 
15  <A href="../samples.html" onMouseOut="rolloverOff('side-samples');" onMouseOver="rolloverOn('side-samples');"><IMG alt="Samples" border="0" height="12" hspace="0" name="side-samples" onLoad="rolloverLoad('side-samples','../graphics/samples-label-2.jpg','../graphics/samples-label-3.jpg');" src="../graphics/samples-label-3.jpg" vspace="0" width="120"></A><BR>
16  <A href="../api.html" onMouseOut="rolloverOff('side-api');" onMouseOver="rolloverOn('side-api');"><IMG alt="API Docs" border="0" height="12" hspace="0" name="side-api" onLoad="rolloverLoad('side-api','../graphics/api-label-2.jpg','../graphics/api-label-3.jpg');" src="../graphics/api-label-3.jpg" vspace="0" width="120"></A><BR> 
17
18  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR> 
19  <A href="../ApacheDOMC++Binding.html" onMouseOut="rolloverOff('side-ext-68');" onMouseOver="rolloverOn('side-ext-68');"><IMG alt="DOM C++ Binding" border="0" height="12" hspace="0" name="side-ext-68" onLoad="rolloverLoad('side-ext-68','../graphics/ext-68-label-2.jpg','../graphics/ext-68-label-3.jpg');" src="../graphics/ext-68-label-3.jpg" vspace="0" width="120"></A><BR>
20
21  <A href="../program.html" onMouseOut="rolloverOff('side-program');" onMouseOver="rolloverOn('side-program');"><IMG alt="Programming" border="0" height="12" hspace="0" name="side-program" onLoad="rolloverLoad('side-program','../graphics/program-label-2.jpg','../graphics/program-label-3.jpg');" src="../graphics/program-label-3.jpg" vspace="0" width="120"></A><BR>
22  <A href="../migrate.html" onMouseOut="rolloverOff('side-migrate');" onMouseOver="rolloverOn('side-migrate');"><IMG alt="Migration Guide" border="0" height="12" hspace="0" name="side-migrate" onLoad="rolloverLoad('side-migrate','../graphics/migrate-label-2.jpg','../graphics/migrate-label-3.jpg');" src="../graphics/migrate-label-3.jpg" vspace="0" width="120"></A><BR>
23
24  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
25
26  <A href="../feedback.html" onMouseOut="rolloverOff('side-feedback');" onMouseOver="rolloverOn('side-feedback');"><IMG alt="Feedback" border="0" height="12" hspace="0" name="side-feedback" onLoad="rolloverLoad('side-feedback','../graphics/feedback-label-2.jpg','../graphics/feedback-label-3.jpg');" src="../graphics/feedback-label-3.jpg" vspace="0" width="120"></A><BR>
27  <A href="../bug-report.html" onMouseOut="rolloverOff('side-bug-report');" onMouseOver="rolloverOn('side-bug-report');"><IMG alt="Bug-Reporting" border="0" height="12" hspace="0" name="side-bug-report" onLoad="rolloverLoad('side-bug-report','../graphics/bug-report-label-2.jpg','../graphics/bug-report-label-3.jpg');" src="../graphics/bug-report-label-3.jpg" vspace="0" width="120"></A><BR> 
28  <A href="../pdf.html" onMouseOut="rolloverOff('side-pdf');" onMouseOver="rolloverOn('side-pdf');"><IMG alt="PDF Document" border="0" height="12" hspace="0" name="side-pdf" onLoad="rolloverLoad('side-pdf','../graphics/pdf-label-2.jpg','../graphics/pdf-label-3.jpg');" src="../graphics/pdf-label-3.jpg" vspace="0" width="120"></A><BR>
29
30  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
31
32  <A href="http://xml.apache.org/websrc/cvsweb.cgi/xml-xerces/c/" onMouseOut="rolloverOff('side-ext-100');" onMouseOver="rolloverOn('side-ext-100');"><IMG alt="CVS Repository" border="0" height="12" hspace="0" name="side-ext-100" onLoad="rolloverLoad('side-ext-100','../graphics/ext-100-label-2.jpg','../graphics/ext-100-label-3.jpg');" src="../graphics/ext-100-label-3.jpg" vspace="0" width="120"></A><BR>
33
34  <A href="http://marc.theaimsgroup.com/?l=xerces-c-dev" onMouseOut="rolloverOff('side-ext-102');" onMouseOver="rolloverOn('side-ext-102');"><IMG alt="Mail Archive" border="0" height="12" hspace="0" name="side-ext-102" onLoad="rolloverLoad('side-ext-102','../graphics/ext-102-label-2.jpg','../graphics/ext-102-label-3.jpg');" src="../graphics/ext-102-label-3.jpg" vspace="0" width="120"></A><BR>
35
36
37<IMG border="0" height="14" hspace="0" src="../resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD>
38    <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#FFFFFF" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="../resources/void.gif" vspace="0" width="2"><B>API Docs for SAX and DOM</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
39
40            <P>
41<!-- Generated by Doxygen 1.2.14 -->
42<center>
43<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="classes.html">Alphabetical List</a> &nbsp; <a class="qindex" href="annotated.html">Compound List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; <a class="qindex" href="globals.html">File Members</a> &nbsp; </center>
44<hr><h1>DOMRange  Class Reference</h1><a href="classDOMRange-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
45<tr><td colspan=2><br><h2>Public Types</h2></td></tr>
46<tr><td colspan="2"><div class="groupHeader">Public Contants</div></td></tr>
47<tr><td nowrap align=right valign=top>enum &nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z146_0">CompareHow</a> { <a class="el" href="classDOMRange.html#z146_0s0">START_TO_START</a> =  0,
48<a class="el" href="classDOMRange.html#z146_0s1">START_TO_END</a> =  1,
49<a class="el" href="classDOMRange.html#z146_0s2">END_TO_END</a> =  2,
50<a class="el" href="classDOMRange.html#z146_0s3">END_TO_START</a> =  3
51 }</td></tr>
52<tr><td>&nbsp;</td><td><font size=-1><em>Constants CompareHow.</em> <a href="#z146_0">More...</a><em></em></font><br><br></td></tr>
53<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
54<tr><td colspan="2"><div class="groupHeader">Destructor</div></td></tr>
55<tr><td nowrap align=right valign=top>virtual&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z145_0">~DOMRange</a> ()</td></tr>
56<tr><td>&nbsp;</td><td><font size=-1><em>Destructor.</em> <a href="#z145_0">More...</a><em></em></font><br><br></td></tr>
57<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 2</div></td></tr>
58<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_0">getStartContainer</a> () const=0</td></tr>
59<tr><td>&nbsp;</td><td><font size=-1><em><a class="el" href="classDOMNode.html">DOMNode</a> within which the Range begins.</em> <a href="#z147_0">More...</a><em></em></font><br><br></td></tr>
60<tr><td nowrap align=right valign=top>virtual XMLSize_t&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_1">getStartOffset</a> () const=0</td></tr>
61<tr><td>&nbsp;</td><td><font size=-1><em>Offset within the starting node of the Range.</em> <a href="#z147_1">More...</a><em></em></font><br><br></td></tr>
62<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_2">getEndContainer</a> () const=0</td></tr>
63<tr><td>&nbsp;</td><td><font size=-1><em><a class="el" href="classDOMNode.html">DOMNode</a> within which the Range ends.</em> <a href="#z147_2">More...</a><em></em></font><br><br></td></tr>
64<tr><td nowrap align=right valign=top>virtual XMLSize_t&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_3">getEndOffset</a> () const=0</td></tr>
65<tr><td>&nbsp;</td><td><font size=-1><em>Offset within the ending node of the Range.</em> <a href="#z147_3">More...</a><em></em></font><br><br></td></tr>
66<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_4">getCollapsed</a> () const=0</td></tr>
67<tr><td>&nbsp;</td><td><font size=-1><em>TRUE if the Range is collapsed.</em> <a href="#z147_4">More...</a><em></em></font><br><br></td></tr>
68<tr><td nowrap align=right valign=top>virtual const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_5">getCommonAncestorContainer</a> () const=0</td></tr>
69<tr><td>&nbsp;</td><td><font size=-1><em>The deepest common ancestor container of the Range's two boundary-points.</em> <a href="#z147_5">More...</a><em></em></font><br><br></td></tr>
70<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_6">setStart</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode, XMLSize_t offset)=0</td></tr>
71<tr><td>&nbsp;</td><td><font size=-1><em>Sets the attributes describing the start of the Range.</em> <a href="#z147_6">More...</a><em></em></font><br><br></td></tr>
72<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_7">setEnd</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode, XMLSize_t offset)=0</td></tr>
73<tr><td>&nbsp;</td><td><font size=-1><em>Sets the attributes describing the end of a Range.</em> <a href="#z147_7">More...</a><em></em></font><br><br></td></tr>
74<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_8">setStartBefore</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
75<tr><td>&nbsp;</td><td><font size=-1><em>Sets the start position to be before a node.</em> <a href="#z147_8">More...</a><em></em></font><br><br></td></tr>
76<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_9">setStartAfter</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
77<tr><td>&nbsp;</td><td><font size=-1><em>Sets the start position to be after a node.</em> <a href="#z147_9">More...</a><em></em></font><br><br></td></tr>
78<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_10">setEndBefore</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
79<tr><td>&nbsp;</td><td><font size=-1><em>Sets the end position to be before a node.</em> <a href="#z147_10">More...</a><em></em></font><br><br></td></tr>
80<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_11">setEndAfter</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
81<tr><td>&nbsp;</td><td><font size=-1><em>Sets the end of a Range to be after a node.</em> <a href="#z147_11">More...</a><em></em></font><br><br></td></tr>
82<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_12">collapse</a> (bool toStart)=0</td></tr>
83<tr><td>&nbsp;</td><td><font size=-1><em>Collapse a Range onto one of its boundary-points.</em> <a href="#z147_12">More...</a><em></em></font><br><br></td></tr>
84<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_13">selectNode</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
85<tr><td>&nbsp;</td><td><font size=-1><em>Select a node and its contents.</em> <a href="#z147_13">More...</a><em></em></font><br><br></td></tr>
86<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_14">selectNodeContents</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *refNode)=0</td></tr>
87<tr><td>&nbsp;</td><td><font size=-1><em>Select the contents within a node.</em> <a href="#z147_14">More...</a><em></em></font><br><br></td></tr>
88<tr><td nowrap align=right valign=top>virtual short&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_15">compareBoundaryPoints</a> (<a class="el" href="classDOMRange.html#z146_0">CompareHow</a> how, const DOMRange *sourceRange) const=0</td></tr>
89<tr><td>&nbsp;</td><td><font size=-1><em>Compare the boundary-points of two Ranges in a document.</em> <a href="#z147_15">More...</a><em></em></font><br><br></td></tr>
90<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_16">deleteContents</a> ()=0</td></tr>
91<tr><td>&nbsp;</td><td><font size=-1><em>Removes the contents of a Range from the containing document or document fragment without returning a reference to the removed content.</em> <a href="#z147_16">More...</a><em></em></font><br><br></td></tr>
92<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_17">extractContents</a> ()=0</td></tr>
93<tr><td>&nbsp;</td><td><font size=-1><em>Moves the contents of a Range from the containing document or document fragment to a new <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>.</em> <a href="#z147_17">More...</a><em></em></font><br><br></td></tr>
94<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_18">cloneContents</a> () const=0</td></tr>
95<tr><td>&nbsp;</td><td><font size=-1><em>Duplicates the contents of a Range.</em> <a href="#z147_18">More...</a><em></em></font><br><br></td></tr>
96<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_19">insertNode</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *newNode)=0</td></tr>
97<tr><td>&nbsp;</td><td><font size=-1><em>Inserts a node into the <a class="el" href="classDOMDocument.html">DOMDocument</a> or <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> at the start of the Range.</em> <a href="#z147_19">More...</a><em></em></font><br><br></td></tr>
98<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_20">surroundContents</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *newParent)=0</td></tr>
99<tr><td>&nbsp;</td><td><font size=-1><em>Reparents the contents of the Range to the given node and inserts the node at the position of the start of the Range.</em> <a href="#z147_20">More...</a><em></em></font><br><br></td></tr>
100<tr><td nowrap align=right valign=top>virtual DOMRange *&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_21">cloneRange</a> () const=0</td></tr>
101<tr><td>&nbsp;</td><td><font size=-1><em>Produces a new Range whose boundary-points are equal to the boundary-points of the Range.</em> <a href="#z147_21">More...</a><em></em></font><br><br></td></tr>
102<tr><td nowrap align=right valign=top>virtual const XMLCh *&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_22">toString</a> () const=0</td></tr>
103<tr><td>&nbsp;</td><td><font size=-1><em>Returns the contents of a Range as a string.</em> <a href="#z147_22">More...</a><em></em></font><br><br></td></tr>
104<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z147_23">detach</a> ()=0</td></tr>
105<tr><td>&nbsp;</td><td><font size=-1><em>Called to indicate that the Range is no longer in use and that the implementation may relinquish any resources associated with this Range.</em> <a href="#z147_23">More...</a><em></em></font><br><br></td></tr>
106<tr><td colspan="2"><div class="groupHeader">Non-standard Extension</div></td></tr>
107<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z148_0">release</a> ()=0</td></tr>
108<tr><td>&nbsp;</td><td><font size=-1><em>Called to indicate that this Range is no longer in use and that the implementation may relinquish any resources associated with it.</em> <a href="#z148_0">More...</a><em></em></font><br><br></td></tr>
109<tr><td colspan=2><br><h2>Protected Methods</h2></td></tr>
110<tr><td colspan="2"><div class="groupHeader">Hidden constructors</div></td></tr>
111<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classDOMRange.html#z143_0">DOMRange</a> ()</td></tr>
112</table>
113<hr><a name="_details"></a><h2>Detailed Description</h2>
114
115<p>
116See 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>
117Since: </b><dd>
118DOM Level 2 </dl>
119<p>
120<hr><h2>Member Enumeration Documentation</h2>
121<a name="z146_0" doxytag="DOMRange::CompareHow"></a><p>
122<table width="100%" cellpadding="2" cellspacing="0" border="0">
123  <tr>
124    <td class="md">
125      <table cellpadding="0" cellspacing="0" border="0">
126        <tr>
127          <td class="md" nowrap valign="top"> enum DOMRange::CompareHow
128      </table>
129    </td>
130  </tr>
131</table>
132<table cellspacing=5 cellpadding=0 border=0>
133  <tr>
134    <td>
135      &nbsp;
136    </td>
137    <td>
138
139<p>
140Constants CompareHow.
141<p>
142
143<p>
144<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.
145<p>
146
147<p>
148<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.
149<p>
150
151<p>
152<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.
153<p>
154
155<p>
156<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.
157<p>
158<dl compact><dt><b>
159Since: </b><dd>
160DOM Level 2 </dl><dl compact><dt><b>
161Enumeration values:</b><dd>
162<table border=0 cellspacing=2 cellpadding=0>
163<tr><td valign=top><em><a name="z146_0s0" doxytag="START_TO_START"></a><em>START_TO_START</em></em>&nbsp;</td><td>
164</td></tr>
165<tr><td valign=top><em><a name="z146_0s1" doxytag="START_TO_END"></a><em>START_TO_END</em></em>&nbsp;</td><td>
166</td></tr>
167<tr><td valign=top><em><a name="z146_0s2" doxytag="END_TO_END"></a><em>END_TO_END</em></em>&nbsp;</td><td>
168</td></tr>
169<tr><td valign=top><em><a name="z146_0s3" doxytag="END_TO_START"></a><em>END_TO_START</em></em>&nbsp;</td><td>
170</td></tr>
171</table>
172</dl>
173    </td>
174  </tr>
175</table>
176<hr><h2>Constructor &amp; Destructor Documentation</h2>
177<a name="z143_0" doxytag="DOMRange::DOMRange"></a><p>
178<table width="100%" cellpadding="2" cellspacing="0" border="0">
179  <tr>
180    <td class="md">
181      <table cellpadding="0" cellspacing="0" border="0">
182        <tr>
183          <td class="md" nowrap valign="top"> DOMRange::DOMRange </td>
184          <td class="md" valign="top">(&nbsp;</td>
185          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
186          <td class="md" valign="top">)&nbsp;</td>
187          <td class="md" nowrap><code> [protected]</code></td>
188        </tr>
189
190      </table>
191    </td>
192  </tr>
193</table>
194<table cellspacing=5 cellpadding=0 border=0>
195  <tr>
196    <td>
197      &nbsp;
198    </td>
199    <td>
200
201<p>
202    </td>
203  </tr>
204</table>
205<a name="z145_0" doxytag="DOMRange::~DOMRange"></a><p>
206<table width="100%" cellpadding="2" cellspacing="0" border="0">
207  <tr>
208    <td class="md">
209      <table cellpadding="0" cellspacing="0" border="0">
210        <tr>
211          <td class="md" nowrap valign="top"> virtual DOMRange::~DOMRange </td>
212          <td class="md" valign="top">(&nbsp;</td>
213          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
214          <td class="md" valign="top">)&nbsp;</td>
215          <td class="md" nowrap><code> [virtual]</code></td>
216        </tr>
217
218      </table>
219    </td>
220  </tr>
221</table>
222<table cellspacing=5 cellpadding=0 border=0>
223  <tr>
224    <td>
225      &nbsp;
226    </td>
227    <td>
228
229<p>
230Destructor.
231<p>
232    </td>
233  </tr>
234</table>
235<hr><h2>Member Function Documentation</h2>
236<a name="z147_18" doxytag="DOMRange::cloneContents"></a><p>
237<table width="100%" cellpadding="2" cellspacing="0" border="0">
238  <tr>
239    <td class="md">
240      <table cellpadding="0" cellspacing="0" border="0">
241        <tr>
242          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>* DOMRange::cloneContents </td>
243          <td class="md" valign="top">(&nbsp;</td>
244          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
245          <td class="md" valign="top">)&nbsp;</td>
246          <td class="md" nowrap> const<code> [pure virtual]</code></td>
247        </tr>
248
249      </table>
250    </td>
251  </tr>
252</table>
253<table cellspacing=5 cellpadding=0 border=0>
254  <tr>
255    <td>
256      &nbsp;
257    </td>
258    <td>
259
260<p>
261Duplicates the contents of a Range.
262<p>
263<dl compact><dt><b>
264Returns: </b><dd>
265A <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> that contains content equivalent to this Range. </dl><dl compact><dt><b>
266Exceptions: </b><dd>
267<table border=0 cellspacing=2 cellpadding=0>
268<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
269 HIERARCHY_REQUEST_ERR: Raised if a <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> node would be extracted into the new <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>. <br>
270INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
271</table>
272</dl><dl compact><dt><b>
273Since: </b><dd>
274DOM Level 2 </dl>    </td>
275  </tr>
276</table>
277<a name="z147_21" doxytag="DOMRange::cloneRange"></a><p>
278<table width="100%" cellpadding="2" cellspacing="0" border="0">
279  <tr>
280    <td class="md">
281      <table cellpadding="0" cellspacing="0" border="0">
282        <tr>
283          <td class="md" nowrap valign="top"> virtual DOMRange* DOMRange::cloneRange </td>
284          <td class="md" valign="top">(&nbsp;</td>
285          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
286          <td class="md" valign="top">)&nbsp;</td>
287          <td class="md" nowrap> const<code> [pure virtual]</code></td>
288        </tr>
289
290      </table>
291    </td>
292  </tr>
293</table>
294<table cellspacing=5 cellpadding=0 border=0>
295  <tr>
296    <td>
297      &nbsp;
298    </td>
299    <td>
300
301<p>
302Produces a new Range whose boundary-points are equal to the boundary-points of the Range.
303<p>
304<dl compact><dt><b>
305Returns: </b><dd>
306The duplicated Range. </dl><dl compact><dt><b>
307Exceptions: </b><dd>
308<table border=0 cellspacing=2 cellpadding=0>
309<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
310 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
311</table>
312</dl><dl compact><dt><b>
313Since: </b><dd>
314DOM Level 2 </dl>    </td>
315  </tr>
316</table>
317<a name="z147_12" doxytag="DOMRange::collapse"></a><p>
318<table width="100%" cellpadding="2" cellspacing="0" border="0">
319  <tr>
320    <td class="md">
321      <table cellpadding="0" cellspacing="0" border="0">
322        <tr>
323          <td class="md" nowrap valign="top"> virtual void DOMRange::collapse </td>
324          <td class="md" valign="top">(&nbsp;</td>
325          <td class="md" nowrap valign="top">bool&nbsp;</td>
326          <td class="mdname1" valign="top" nowrap>&nbsp; <em>toStart</em>          </td>
327          <td class="md" valign="top">)&nbsp;</td>
328          <td class="md" nowrap><code> [pure virtual]</code></td>
329        </tr>
330
331      </table>
332    </td>
333  </tr>
334</table>
335<table cellspacing=5 cellpadding=0 border=0>
336  <tr>
337    <td>
338      &nbsp;
339    </td>
340    <td>
341
342<p>
343Collapse a Range onto one of its boundary-points.
344<p>
345<dl compact><dt><b>
346Parameters: </b><dd>
347<table border=0 cellspacing=2 cellpadding=0>
348<tr><td valign=top><em>toStart</em>&nbsp;</td><td>
349If TRUE, collapses the Range onto its start; if FALSE, collapses it onto its end. </td></tr>
350</table>
351</dl><dl compact><dt><b>
352Exceptions: </b><dd>
353<table border=0 cellspacing=2 cellpadding=0>
354<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
355 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
356</table>
357</dl><dl compact><dt><b>
358Since: </b><dd>
359DOM Level 2 </dl>    </td>
360  </tr>
361</table>
362<a name="z147_15" doxytag="DOMRange::compareBoundaryPoints"></a><p>
363<table width="100%" cellpadding="2" cellspacing="0" border="0">
364  <tr>
365    <td class="md">
366      <table cellpadding="0" cellspacing="0" border="0">
367        <tr>
368          <td class="md" nowrap valign="top"> virtual short DOMRange::compareBoundaryPoints </td>
369          <td class="md" valign="top">(&nbsp;</td>
370          <td class="md" nowrap valign="top"><a class="el" href="classDOMRange.html#z146_0">CompareHow</a>&nbsp;</td>
371          <td class="mdname" nowrap>&nbsp; <em>how</em>, </td>
372        </tr>
373        <tr>
374          <td></td>
375          <td></td>
376          <td class="md" nowrap>const DOMRange *&nbsp;</td>
377          <td class="mdname" nowrap>&nbsp; <em>sourceRange</em></td>
378        </tr>
379        <tr>
380          <td></td>
381          <td class="md">)&nbsp;</td>
382          <td class="md" colspan="2"> const<code> [pure virtual]</code></td>
383        </tr>
384
385      </table>
386    </td>
387  </tr>
388</table>
389<table cellspacing=5 cellpadding=0 border=0>
390  <tr>
391    <td>
392      &nbsp;
393    </td>
394    <td>
395
396<p>
397Compare the boundary-points of two Ranges in a document.
398<p>
399<dl compact><dt><b>
400Parameters: </b><dd>
401<table border=0 cellspacing=2 cellpadding=0>
402<tr><td valign=top><em>how</em>&nbsp;</td><td>
403A code representing the type of comparison, as defined above. </td></tr>
404<tr><td valign=top><em>sourceRange</em>&nbsp;</td><td>
405The <code>Range</code> on which this current <code>Range</code> is compared to. </td></tr>
406</table>
407</dl><dl compact><dt><b>
408Returns: </b><dd>
409-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>. </dl><dl compact><dt><b>
410Exceptions: </b><dd>
411<table border=0 cellspacing=2 cellpadding=0>
412<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
413 WRONG_DOCUMENT_ERR: Raised if the two Ranges are not in the same <a class="el" href="classDOMDocument.html">DOMDocument</a> or <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>. <br>
414INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
415</table>
416</dl><dl compact><dt><b>
417Since: </b><dd>
418DOM Level 2 </dl>    </td>
419  </tr>
420</table>
421<a name="z147_16" doxytag="DOMRange::deleteContents"></a><p>
422<table width="100%" cellpadding="2" cellspacing="0" border="0">
423  <tr>
424    <td class="md">
425      <table cellpadding="0" cellspacing="0" border="0">
426        <tr>
427          <td class="md" nowrap valign="top"> virtual void DOMRange::deleteContents </td>
428          <td class="md" valign="top">(&nbsp;</td>
429          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
430          <td class="md" valign="top">)&nbsp;</td>
431          <td class="md" nowrap><code> [pure virtual]</code></td>
432        </tr>
433
434      </table>
435    </td>
436  </tr>
437</table>
438<table cellspacing=5 cellpadding=0 border=0>
439  <tr>
440    <td>
441      &nbsp;
442    </td>
443    <td>
444
445<p>
446Removes the contents of a Range from the containing document or document fragment without returning a reference to the removed content.
447<p>
448<dl compact><dt><b>
449Exceptions: </b><dd>
450<table border=0 cellspacing=2 cellpadding=0>
451<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
452 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>
453INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
454</table>
455</dl><dl compact><dt><b>
456Since: </b><dd>
457DOM Level 2 </dl>    </td>
458  </tr>
459</table>
460<a name="z147_23" doxytag="DOMRange::detach"></a><p>
461<table width="100%" cellpadding="2" cellspacing="0" border="0">
462  <tr>
463    <td class="md">
464      <table cellpadding="0" cellspacing="0" border="0">
465        <tr>
466          <td class="md" nowrap valign="top"> virtual void DOMRange::detach </td>
467          <td class="md" valign="top">(&nbsp;</td>
468          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
469          <td class="md" valign="top">)&nbsp;</td>
470          <td class="md" nowrap><code> [pure virtual]</code></td>
471        </tr>
472
473      </table>
474    </td>
475  </tr>
476</table>
477<table cellspacing=5 cellpadding=0 border=0>
478  <tr>
479    <td>
480      &nbsp;
481    </td>
482    <td>
483
484<p>
485Called to indicate that the Range is no longer in use and that the implementation may relinquish any resources associated with this Range.
486<p>
487Subsequent 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>
488Exceptions: </b><dd>
489<table border=0 cellspacing=2 cellpadding=0>
490<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
491 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
492</table>
493</dl><dl compact><dt><b>
494Since: </b><dd>
495DOM Level 2 </dl>    </td>
496  </tr>
497</table>
498<a name="z147_17" doxytag="DOMRange::extractContents"></a><p>
499<table width="100%" cellpadding="2" cellspacing="0" border="0">
500  <tr>
501    <td class="md">
502      <table cellpadding="0" cellspacing="0" border="0">
503        <tr>
504          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>* DOMRange::extractContents </td>
505          <td class="md" valign="top">(&nbsp;</td>
506          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
507          <td class="md" valign="top">)&nbsp;</td>
508          <td class="md" nowrap><code> [pure virtual]</code></td>
509        </tr>
510
511      </table>
512    </td>
513  </tr>
514</table>
515<table cellspacing=5 cellpadding=0 border=0>
516  <tr>
517    <td>
518      &nbsp;
519    </td>
520    <td>
521
522<p>
523Moves the contents of a Range from the containing document or document fragment to a new <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>.
524<p>
525<dl compact><dt><b>
526Returns: </b><dd>
527A <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> containing the extracted contents. </dl><dl compact><dt><b>
528Exceptions: </b><dd>
529<table border=0 cellspacing=2 cellpadding=0>
530<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
531 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>
532HIERARCHY_REQUEST_ERR: Raised if a <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> node would be extracted into the new <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>. <br>
533INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
534</table>
535</dl><dl compact><dt><b>
536Since: </b><dd>
537DOM Level 2 </dl>    </td>
538  </tr>
539</table>
540<a name="z147_4" doxytag="DOMRange::getCollapsed"></a><p>
541<table width="100%" cellpadding="2" cellspacing="0" border="0">
542  <tr>
543    <td class="md">
544      <table cellpadding="0" cellspacing="0" border="0">
545        <tr>
546          <td class="md" nowrap valign="top"> virtual bool DOMRange::getCollapsed </td>
547          <td class="md" valign="top">(&nbsp;</td>
548          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
549          <td class="md" valign="top">)&nbsp;</td>
550          <td class="md" nowrap> const<code> [pure virtual]</code></td>
551        </tr>
552
553      </table>
554    </td>
555  </tr>
556</table>
557<table cellspacing=5 cellpadding=0 border=0>
558  <tr>
559    <td>
560      &nbsp;
561    </td>
562    <td>
563
564<p>
565TRUE if the Range is collapsed.
566<p>
567<dl compact><dt><b>
568Exceptions: </b><dd>
569<table border=0 cellspacing=2 cellpadding=0>
570<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
571 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
572</table>
573</dl><dl compact><dt><b>
574Since: </b><dd>
575DOM Level 2 </dl>    </td>
576  </tr>
577</table>
578<a name="z147_5" doxytag="DOMRange::getCommonAncestorContainer"></a><p>
579<table width="100%" cellpadding="2" cellspacing="0" border="0">
580  <tr>
581    <td class="md">
582      <table cellpadding="0" cellspacing="0" border="0">
583        <tr>
584          <td class="md" nowrap valign="top"> virtual const <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getCommonAncestorContainer </td>
585          <td class="md" valign="top">(&nbsp;</td>
586          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
587          <td class="md" valign="top">)&nbsp;</td>
588          <td class="md" nowrap> const<code> [pure virtual]</code></td>
589        </tr>
590
591      </table>
592    </td>
593  </tr>
594</table>
595<table cellspacing=5 cellpadding=0 border=0>
596  <tr>
597    <td>
598      &nbsp;
599    </td>
600    <td>
601
602<p>
603The deepest common ancestor container of the Range's two boundary-points.
604<p>
605<dl compact><dt><b>
606Exceptions: </b><dd>
607<table border=0 cellspacing=2 cellpadding=0>
608<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
609 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
610</table>
611</dl><dl compact><dt><b>
612Since: </b><dd>
613DOM Level 2 </dl>    </td>
614  </tr>
615</table>
616<a name="z147_2" doxytag="DOMRange::getEndContainer"></a><p>
617<table width="100%" cellpadding="2" cellspacing="0" border="0">
618  <tr>
619    <td class="md">
620      <table cellpadding="0" cellspacing="0" border="0">
621        <tr>
622          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getEndContainer </td>
623          <td class="md" valign="top">(&nbsp;</td>
624          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
625          <td class="md" valign="top">)&nbsp;</td>
626          <td class="md" nowrap> const<code> [pure virtual]</code></td>
627        </tr>
628
629      </table>
630    </td>
631  </tr>
632</table>
633<table cellspacing=5 cellpadding=0 border=0>
634  <tr>
635    <td>
636      &nbsp;
637    </td>
638    <td>
639
640<p>
641<a class="el" href="classDOMNode.html">DOMNode</a> within which the Range ends.
642<p>
643<dl compact><dt><b>
644Exceptions: </b><dd>
645<table border=0 cellspacing=2 cellpadding=0>
646<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
647 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
648</table>
649</dl><dl compact><dt><b>
650Since: </b><dd>
651DOM Level 2 </dl>    </td>
652  </tr>
653</table>
654<a name="z147_3" doxytag="DOMRange::getEndOffset"></a><p>
655<table width="100%" cellpadding="2" cellspacing="0" border="0">
656  <tr>
657    <td class="md">
658      <table cellpadding="0" cellspacing="0" border="0">
659        <tr>
660          <td class="md" nowrap valign="top"> virtual XMLSize_t DOMRange::getEndOffset </td>
661          <td class="md" valign="top">(&nbsp;</td>
662          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
663          <td class="md" valign="top">)&nbsp;</td>
664          <td class="md" nowrap> const<code> [pure virtual]</code></td>
665        </tr>
666
667      </table>
668    </td>
669  </tr>
670</table>
671<table cellspacing=5 cellpadding=0 border=0>
672  <tr>
673    <td>
674      &nbsp;
675    </td>
676    <td>
677
678<p>
679Offset within the ending node of the Range.
680<p>
681<dl compact><dt><b>
682Exceptions: </b><dd>
683<table border=0 cellspacing=2 cellpadding=0>
684<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
685 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
686</table>
687</dl><dl compact><dt><b>
688Since: </b><dd>
689DOM Level 2 </dl>    </td>
690  </tr>
691</table>
692<a name="z147_0" doxytag="DOMRange::getStartContainer"></a><p>
693<table width="100%" cellpadding="2" cellspacing="0" border="0">
694  <tr>
695    <td class="md">
696      <table cellpadding="0" cellspacing="0" border="0">
697        <tr>
698          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMRange::getStartContainer </td>
699          <td class="md" valign="top">(&nbsp;</td>
700          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
701          <td class="md" valign="top">)&nbsp;</td>
702          <td class="md" nowrap> const<code> [pure virtual]</code></td>
703        </tr>
704
705      </table>
706    </td>
707  </tr>
708</table>
709<table cellspacing=5 cellpadding=0 border=0>
710  <tr>
711    <td>
712      &nbsp;
713    </td>
714    <td>
715
716<p>
717<a class="el" href="classDOMNode.html">DOMNode</a> within which the Range begins.
718<p>
719<dl compact><dt><b>
720Exceptions: </b><dd>
721<table border=0 cellspacing=2 cellpadding=0>
722<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
723 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
724</table>
725</dl><dl compact><dt><b>
726Since: </b><dd>
727DOM Level 2 </dl>    </td>
728  </tr>
729</table>
730<a name="z147_1" doxytag="DOMRange::getStartOffset"></a><p>
731<table width="100%" cellpadding="2" cellspacing="0" border="0">
732  <tr>
733    <td class="md">
734      <table cellpadding="0" cellspacing="0" border="0">
735        <tr>
736          <td class="md" nowrap valign="top"> virtual XMLSize_t DOMRange::getStartOffset </td>
737          <td class="md" valign="top">(&nbsp;</td>
738          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
739          <td class="md" valign="top">)&nbsp;</td>
740          <td class="md" nowrap> const<code> [pure virtual]</code></td>
741        </tr>
742
743      </table>
744    </td>
745  </tr>
746</table>
747<table cellspacing=5 cellpadding=0 border=0>
748  <tr>
749    <td>
750      &nbsp;
751    </td>
752    <td>
753
754<p>
755Offset within the starting node of the Range.
756<p>
757<dl compact><dt><b>
758Exceptions: </b><dd>
759<table border=0 cellspacing=2 cellpadding=0>
760<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
761 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
762</table>
763</dl><dl compact><dt><b>
764Since: </b><dd>
765DOM Level 2 </dl>    </td>
766  </tr>
767</table>
768<a name="z147_19" doxytag="DOMRange::insertNode"></a><p>
769<table width="100%" cellpadding="2" cellspacing="0" border="0">
770  <tr>
771    <td class="md">
772      <table cellpadding="0" cellspacing="0" border="0">
773        <tr>
774          <td class="md" nowrap valign="top"> virtual void DOMRange::insertNode </td>
775          <td class="md" valign="top">(&nbsp;</td>
776          <td class="md" nowrap valign="top"><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
777          <td class="mdname1" valign="top" nowrap>&nbsp; <em>newNode</em>          </td>
778          <td class="md" valign="top">)&nbsp;</td>
779          <td class="md" nowrap><code> [pure virtual]</code></td>
780        </tr>
781
782      </table>
783    </td>
784  </tr>
785</table>
786<table cellspacing=5 cellpadding=0 border=0>
787  <tr>
788    <td>
789      &nbsp;
790    </td>
791    <td>
792
793<p>
794Inserts a node into the <a class="el" href="classDOMDocument.html">DOMDocument</a> or <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> at the start of the Range.
795<p>
796If the container is a <a class="el" href="classDOMText.html">DOMText</a> node, this will be split at the start of the Range (as if the <a class="el" href="classDOMText.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="classDOMText.html">DOMText</a> nodes. Adjacent <a class="el" href="classDOMText.html">DOMText</a> nodes will not be automatically merged. If the node to be inserted is a <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> node, the children will be inserted rather than the <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> node itself. <dl compact><dt><b>
797Parameters: </b><dd>
798<table border=0 cellspacing=2 cellpadding=0>
799<tr><td valign=top><em>newNode</em>&nbsp;</td><td>
800The node to insert at the start of the Range </td></tr>
801</table>
802</dl><dl compact><dt><b>
803Exceptions: </b><dd>
804<table border=0 cellspacing=2 cellpadding=0>
805<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
806 NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of the start of the Range is read-only. <br>
807WRONG_DOCUMENT_ERR: Raised if <code>newNode</code> and the container of the start of the Range were not created from the same document. <br>
808HIERARCHY_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>
809INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. </td></tr>
810<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
811 INVALID_NODE_TYPE_ERR: Raised if <code>newNode</code> is an <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMEntity.html">DOMEntity</a>, <a class="el" href="classDOMNotation.html">DOMNotation</a>, or <a class="el" href="classDOMDocument.html">DOMDocument</a> node.</td></tr>
812</table>
813</dl><dl compact><dt><b>
814Since: </b><dd>
815DOM Level 2 </dl>    </td>
816  </tr>
817</table>
818<a name="z148_0" doxytag="DOMRange::release"></a><p>
819<table width="100%" cellpadding="2" cellspacing="0" border="0">
820  <tr>
821    <td class="md">
822      <table cellpadding="0" cellspacing="0" border="0">
823        <tr>
824          <td class="md" nowrap valign="top"> virtual void DOMRange::release </td>
825          <td class="md" valign="top">(&nbsp;</td>
826          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
827          <td class="md" valign="top">)&nbsp;</td>
828          <td class="md" nowrap><code> [pure virtual]</code></td>
829        </tr>
830
831      </table>
832    </td>
833  </tr>
834</table>
835<table cellspacing=5 cellpadding=0 border=0>
836  <tr>
837    <td>
838      &nbsp;
839    </td>
840    <td>
841
842<p>
843Called to indicate that this Range is no longer in use and that the implementation may relinquish any resources associated with it.
844<p>
845(<a class="el" href="classDOMRange.html#z148_0">release</a>() will call <a class="el" href="classDOMRange.html#z147_23">detach</a>() where appropriate)
846<p>
847Access to a released object will lead to unexpected result.     </td>
848  </tr>
849</table>
850<a name="z147_13" doxytag="DOMRange::selectNode"></a><p>
851<table width="100%" cellpadding="2" cellspacing="0" border="0">
852  <tr>
853    <td class="md">
854      <table cellpadding="0" cellspacing="0" border="0">
855        <tr>
856          <td class="md" nowrap valign="top"> virtual void DOMRange::selectNode </td>
857          <td class="md" valign="top">(&nbsp;</td>
858          <td class="md" nowrap valign="top">const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
859          <td class="mdname1" valign="top" nowrap>&nbsp; <em>refNode</em>          </td>
860          <td class="md" valign="top">)&nbsp;</td>
861          <td class="md" nowrap><code> [pure virtual]</code></td>
862        </tr>
863
864      </table>
865    </td>
866  </tr>
867</table>
868<table cellspacing=5 cellpadding=0 border=0>
869  <tr>
870    <td>
871      &nbsp;
872    </td>
873    <td>
874
875<p>
876Select a node and its contents.
877<p>
878<dl compact><dt><b>
879Parameters: </b><dd>
880<table border=0 cellspacing=2 cellpadding=0>
881<tr><td valign=top><em>refNode</em>&nbsp;</td><td>
882The node to select. </td></tr>
883</table>
884</dl><dl compact><dt><b>
885Exceptions: </b><dd>
886<table border=0 cellspacing=2 cellpadding=0>
887<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
888 INVALID_NODE_TYPE_ERR: Raised if an ancestor of <code>refNode</code> is an <a class="el" href="classDOMEntity.html">DOMEntity</a>, <a class="el" href="classDOMNotation.html">DOMNotation</a> or <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMEntity.html">DOMEntity</a>, or <a class="el" href="classDOMNotation.html">DOMNotation</a> node. </td></tr>
889<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
890 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. <br>
891WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
892</table>
893</dl><dl compact><dt><b>
894Since: </b><dd>
895DOM Level 2 </dl>    </td>
896  </tr>
897</table>
898<a name="z147_14" doxytag="DOMRange::selectNodeContents"></a><p>
899<table width="100%" cellpadding="2" cellspacing="0" border="0">
900  <tr>
901    <td class="md">
902      <table cellpadding="0" cellspacing="0" border="0">
903        <tr>
904          <td class="md" nowrap valign="top"> virtual void DOMRange::selectNodeContents </td>
905          <td class="md" valign="top">(&nbsp;</td>
906          <td class="md" nowrap valign="top">const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
907          <td class="mdname1" valign="top" nowrap>&nbsp; <em>refNode</em>          </td>
908          <td class="md" valign="top">)&nbsp;</td>
909          <td class="md" nowrap><code> [pure virtual]</code></td>
910        </tr>
911
912      </table>
913    </td>
914  </tr>
915</table>
916<table cellspacing=5 cellpadding=0 border=0>
917  <tr>
918    <td>
919      &nbsp;
920    </td>
921    <td>
922
923<p>
924Select the contents within a node.
925<p>
926<dl compact><dt><b>
927Parameters: </b><dd>
928<table border=0 cellspacing=2 cellpadding=0>
929<tr><td valign=top><em>refNode</em>&nbsp;</td><td>
930<a class="el" href="classDOMNode.html">DOMNode</a> to select from </td></tr>
931</table>
932</dl><dl compact><dt><b>
933Exceptions: </b><dd>
934<table border=0 cellspacing=2 cellpadding=0>
935<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
936 INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classDOMEntity.html">DOMEntity</a>, <a class="el" href="classDOMNotation.html">DOMNotation</a> or <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> node. </td></tr>
937<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
938 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. <br>
939WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
940</table>
941</dl><dl compact><dt><b>
942Since: </b><dd>
943DOM Level 2 </dl>    </td>
944  </tr>
945</table>
946<a name="z147_7" doxytag="DOMRange::setEnd"></a><p>
947<table width="100%" cellpadding="2" cellspacing="0" border="0">
948  <tr>
949    <td class="md">
950      <table cellpadding="0" cellspacing="0" border="0">
951        <tr>
952          <td class="md" nowrap valign="top"> virtual void DOMRange::setEnd </td>
953          <td class="md" valign="top">(&nbsp;</td>
954          <td class="md" nowrap valign="top">const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
955          <td class="mdname" nowrap>&nbsp; <em>refNode</em>, </td>
956        </tr>
957        <tr>
958          <td></td>
959          <td></td>
960          <td class="md" nowrap>XMLSize_t&nbsp;</td>
961          <td class="mdname" nowrap>&nbsp; <em>offset</em></td>
962        </tr>
963        <tr>
964          <td></td>
965          <td class="md">)&nbsp;</td>
966          <td class="md" colspan="2"><code> [pure virtual]</code></td>
967        </tr>
968
969      </table>
970    </td>
971  </tr>
972</table>
973<table cellspacing=5 cellpadding=0 border=0>
974  <tr>
975    <td>
976      &nbsp;
977    </td>
978    <td>
979
980<p>
981Sets the attributes describing the end of a Range.
982<p>
983<dl compact><dt><b>
984Parameters: </b><dd>
985<table border=0 cellspacing=2 cellpadding=0>
986<tr><td valign=top><em>refNode</em>&nbsp;</td><td>
987The <code>refNode</code> value. This parameter must be different from <code>null</code>. </td></tr>
988<tr><td valign=top><em>offset</em>&nbsp;</td><td>
989The <code>endOffset</code> value. </td></tr>
990</table>
991</dl><dl compact><dt><b>
992Exceptions: </b><dd>
993<table border=0 cellspacing=2 cellpadding=0>
994<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
995 INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classDOMEntity.html">DOMEntity</a>, <a class="el" href="classDOMNotation.html">DOMNotation</a>, or <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> node. </td></tr>
996<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
997 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">DOMCharacterData</a> node (e.g., a <a class="el" href="classDOMText.html">DOMText</a> or <a class="el" href="classDOMComment.html">DOMComment</a> node) or a <a class="el" href="classDOMProcessingInstruction.html">DOMProcessingInstruction</a> node. Child units are Nodes in all other cases. <br>
998INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. <br>
999WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
1000</table>
1001</dl><dl compact><dt><b>
1002Since: </b><dd>
1003DOM Level 2 </dl>    </td>
1004  </tr>
1005</table>
1006<a name="z147_11" doxytag="DOMRange::setEndAfter"></a><p>
1007<table width="100%" cellpadding="2" cellspacing="0" border="0">
1008  <tr>
1009    <td class="md">
1010      <table cellpadding="0" cellspacing="0" border="0">
1011        <tr>
1012          <td class="md" nowrap valign="top"> virtual void DOMRange::setEndAfter </td>
1013          <td class="md" valign="top">(&nbsp;</td>
1014          <td class="md" nowrap valign="top">const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
1015          <td class="mdname1" valign="top" nowrap>&nbsp; <em>refNode</em>          </td>
1016          <td class="md" valign="top">)&nbsp;</td>
1017          <td class="md" nowrap><code> [pure virtual]</code></td>
1018        </tr>
1019
1020      </table>
1021    </td>
1022  </tr>
1023</table>
1024<table cellspacing=5 cellpadding=0 border=0>
1025  <tr>
1026    <td>
1027      &nbsp;
1028    </td>
1029    <td>
1030
1031<p>
1032Sets the end of a Range to be after a node.
1033<p>
1034<dl compact><dt><b>
1035Parameters: </b><dd>
1036<table border=0 cellspacing=2 cellpadding=0>
1037<tr><td valign=top><em>refNode</em>&nbsp;</td><td>
1038Range ends after <code>refNode</code>. </td></tr>
1039</table>
1040</dl><dl compact><dt><b>
1041Exceptions: </b><dd>
1042<table border=0 cellspacing=2 cellpadding=0>
1043<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
1044 INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not a <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMDocument.html">DOMDocument</a> or <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMEntity.html">DOMEntity</a>, or <a class="el" href="classDOMNotation.html">DOMNotation</a> node. </td></tr>
1045<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1046 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. <br>
1047WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
1048</table>
1049</dl><dl compact><dt><b>
1050Since: </b><dd>
1051DOM Level 2 </dl>    </td>
1052  </tr>
1053</table>
1054<a name="z147_10" doxytag="DOMRange::setEndBefore"></a><p>
1055<table width="100%" cellpadding="2" cellspacing="0" border="0">
1056  <tr>
1057    <td class="md">
1058      <table cellpadding="0" cellspacing="0" border="0">
1059        <tr>
1060          <td class="md" nowrap valign="top"> virtual void DOMRange::setEndBefore </td>
1061          <td class="md" valign="top">(&nbsp;</td>
1062          <td class="md" nowrap valign="top">const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
1063          <td class="mdname1" valign="top" nowrap>&nbsp; <em>refNode</em>          </td>
1064          <td class="md" valign="top">)&nbsp;</td>
1065          <td class="md" nowrap><code> [pure virtual]</code></td>
1066        </tr>
1067
1068      </table>
1069    </td>
1070  </tr>
1071</table>
1072<table cellspacing=5 cellpadding=0 border=0>
1073  <tr>
1074    <td>
1075      &nbsp;
1076    </td>
1077    <td>
1078
1079<p>
1080Sets the end position to be before a node.
1081<p>
1082<dl compact><dt><b>
1083Parameters: </b><dd>
1084<table border=0 cellspacing=2 cellpadding=0>
1085<tr><td valign=top><em>refNode</em>&nbsp;</td><td>
1086Range ends before <code>refNode</code> </td></tr>
1087</table>
1088</dl><dl compact><dt><b>
1089Exceptions: </b><dd>
1090<table border=0 cellspacing=2 cellpadding=0>
1091<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
1092 INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMDocument.html">DOMDocument</a>, or <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMEntity.html">DOMEntity</a>, or <a class="el" href="classDOMNotation.html">DOMNotation</a> node. </td></tr>
1093<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1094 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. <br>
1095WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
1096</table>
1097</dl><dl compact><dt><b>
1098Since: </b><dd>
1099DOM Level 2 </dl>    </td>
1100  </tr>
1101</table>
1102<a name="z147_6" doxytag="DOMRange::setStart"></a><p>
1103<table width="100%" cellpadding="2" cellspacing="0" border="0">
1104  <tr>
1105    <td class="md">
1106      <table cellpadding="0" cellspacing="0" border="0">
1107        <tr>
1108          <td class="md" nowrap valign="top"> virtual void DOMRange::setStart </td>
1109          <td class="md" valign="top">(&nbsp;</td>
1110          <td class="md" nowrap valign="top">const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
1111          <td class="mdname" nowrap>&nbsp; <em>refNode</em>, </td>
1112        </tr>
1113        <tr>
1114          <td></td>
1115          <td></td>
1116          <td class="md" nowrap>XMLSize_t&nbsp;</td>
1117          <td class="mdname" nowrap>&nbsp; <em>offset</em></td>
1118        </tr>
1119        <tr>
1120          <td></td>
1121          <td class="md">)&nbsp;</td>
1122          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1123        </tr>
1124
1125      </table>
1126    </td>
1127  </tr>
1128</table>
1129<table cellspacing=5 cellpadding=0 border=0>
1130  <tr>
1131    <td>
1132      &nbsp;
1133    </td>
1134    <td>
1135
1136<p>
1137Sets the attributes describing the start of the Range.
1138<p>
1139<dl compact><dt><b>
1140Parameters: </b><dd>
1141<table border=0 cellspacing=2 cellpadding=0>
1142<tr><td valign=top><em>refNode</em>&nbsp;</td><td>
1143The <code>refNode</code> value. This parameter must be different from <code>null</code>. </td></tr>
1144<tr><td valign=top><em>offset</em>&nbsp;</td><td>
1145The <code>startOffset</code> value. </td></tr>
1146</table>
1147</dl><dl compact><dt><b>
1148Exceptions: </b><dd>
1149<table border=0 cellspacing=2 cellpadding=0>
1150<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
1151 INVALID_NODE_TYPE_ERR: Raised if <code>refNode</code> or an ancestor of <code>refNode</code> is an <a class="el" href="classDOMEntity.html">DOMEntity</a>, <a class="el" href="classDOMNotation.html">DOMNotation</a>, or <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> node. </td></tr>
1152<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1153 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">DOMCharacterData</a> node (e.g., a <a class="el" href="classDOMText.html">DOMText</a> or <a class="el" href="classDOMComment.html">DOMComment</a> node) or a <a class="el" href="classDOMProcessingInstruction.html">DOMProcessingInstruction</a> node. Child units are Nodes in all other cases. <br>
1154INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. <br>
1155WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
1156</table>
1157</dl><dl compact><dt><b>
1158Since: </b><dd>
1159DOM Level 2 </dl>    </td>
1160  </tr>
1161</table>
1162<a name="z147_9" doxytag="DOMRange::setStartAfter"></a><p>
1163<table width="100%" cellpadding="2" cellspacing="0" border="0">
1164  <tr>
1165    <td class="md">
1166      <table cellpadding="0" cellspacing="0" border="0">
1167        <tr>
1168          <td class="md" nowrap valign="top"> virtual void DOMRange::setStartAfter </td>
1169          <td class="md" valign="top">(&nbsp;</td>
1170          <td class="md" nowrap valign="top">const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
1171          <td class="mdname1" valign="top" nowrap>&nbsp; <em>refNode</em>          </td>
1172          <td class="md" valign="top">)&nbsp;</td>
1173          <td class="md" nowrap><code> [pure virtual]</code></td>
1174        </tr>
1175
1176      </table>
1177    </td>
1178  </tr>
1179</table>
1180<table cellspacing=5 cellpadding=0 border=0>
1181  <tr>
1182    <td>
1183      &nbsp;
1184    </td>
1185    <td>
1186
1187<p>
1188Sets the start position to be after a node.
1189<p>
1190<dl compact><dt><b>
1191Parameters: </b><dd>
1192<table border=0 cellspacing=2 cellpadding=0>
1193<tr><td valign=top><em>refNode</em>&nbsp;</td><td>
1194Range starts after <code>refNode</code> </td></tr>
1195</table>
1196</dl><dl compact><dt><b>
1197Exceptions: </b><dd>
1198<table border=0 cellspacing=2 cellpadding=0>
1199<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
1200 INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMDocument.html">DOMDocument</a>, or <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMEntity.html">DOMEntity</a>, or <a class="el" href="classDOMNotation.html">DOMNotation</a> node. </td></tr>
1201<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1202 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. <br>
1203WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
1204</table>
1205</dl><dl compact><dt><b>
1206Since: </b><dd>
1207DOM Level 2 </dl>    </td>
1208  </tr>
1209</table>
1210<a name="z147_8" doxytag="DOMRange::setStartBefore"></a><p>
1211<table width="100%" cellpadding="2" cellspacing="0" border="0">
1212  <tr>
1213    <td class="md">
1214      <table cellpadding="0" cellspacing="0" border="0">
1215        <tr>
1216          <td class="md" nowrap valign="top"> virtual void DOMRange::setStartBefore </td>
1217          <td class="md" valign="top">(&nbsp;</td>
1218          <td class="md" nowrap valign="top">const <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
1219          <td class="mdname1" valign="top" nowrap>&nbsp; <em>refNode</em>          </td>
1220          <td class="md" valign="top">)&nbsp;</td>
1221          <td class="md" nowrap><code> [pure virtual]</code></td>
1222        </tr>
1223
1224      </table>
1225    </td>
1226  </tr>
1227</table>
1228<table cellspacing=5 cellpadding=0 border=0>
1229  <tr>
1230    <td>
1231      &nbsp;
1232    </td>
1233    <td>
1234
1235<p>
1236Sets the start position to be before a node.
1237<p>
1238<dl compact><dt><b>
1239Parameters: </b><dd>
1240<table border=0 cellspacing=2 cellpadding=0>
1241<tr><td valign=top><em>refNode</em>&nbsp;</td><td>
1242Range starts before <code>refNode</code> </td></tr>
1243</table>
1244</dl><dl compact><dt><b>
1245Exceptions: </b><dd>
1246<table border=0 cellspacing=2 cellpadding=0>
1247<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
1248 INVALID_NODE_TYPE_ERR: Raised if the root container of <code>refNode</code> is not an <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMDocument.html">DOMDocument</a>, or <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> node or if <code>refNode</code> is a <a class="el" href="classDOMDocument.html">DOMDocument</a>, <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>, <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMEntity.html">DOMEntity</a>, or <a class="el" href="classDOMNotation.html">DOMNotation</a> node. </td></tr>
1249<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1250 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. <br>
1251WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created from a different document than the one that created this range.</td></tr>
1252</table>
1253</dl><dl compact><dt><b>
1254Since: </b><dd>
1255DOM Level 2 </dl>    </td>
1256  </tr>
1257</table>
1258<a name="z147_20" doxytag="DOMRange::surroundContents"></a><p>
1259<table width="100%" cellpadding="2" cellspacing="0" border="0">
1260  <tr>
1261    <td class="md">
1262      <table cellpadding="0" cellspacing="0" border="0">
1263        <tr>
1264          <td class="md" nowrap valign="top"> virtual void DOMRange::surroundContents </td>
1265          <td class="md" valign="top">(&nbsp;</td>
1266          <td class="md" nowrap valign="top"><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
1267          <td class="mdname1" valign="top" nowrap>&nbsp; <em>newParent</em>          </td>
1268          <td class="md" valign="top">)&nbsp;</td>
1269          <td class="md" nowrap><code> [pure virtual]</code></td>
1270        </tr>
1271
1272      </table>
1273    </td>
1274  </tr>
1275</table>
1276<table cellspacing=5 cellpadding=0 border=0>
1277  <tr>
1278    <td>
1279      &nbsp;
1280    </td>
1281    <td>
1282
1283<p>
1284Reparents the contents of the Range to the given node and inserts the node at the position of the start of the Range.
1285<p>
1286<dl compact><dt><b>
1287Parameters: </b><dd>
1288<table border=0 cellspacing=2 cellpadding=0>
1289<tr><td valign=top><em>newParent</em>&nbsp;</td><td>
1290The node to surround the contents with. </td></tr>
1291</table>
1292</dl><dl compact><dt><b>
1293Exceptions: </b><dd>
1294<table border=0 cellspacing=2 cellpadding=0>
1295<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1296 NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of either boundary-point of the Range is read-only. <br>
1297WRONG_DOCUMENT_ERR: Raised if <code> newParent</code> and the container of the start of the Range were not created from the same document. <br>
1298HIERARCHY_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>
1299INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object. </td></tr>
1300<tr><td valign=top><em><a class="el" href="classDOMRangeException.html">DOMRangeException</a></em>&nbsp;</td><td>
1301 BAD_BOUNDARYPOINTS_ERR: Raised if the Range partially selects a non-text node. <br>
1302INVALID_NODE_TYPE_ERR: Raised if <code> node</code> is an <a class="el" href="classDOMAttr.html">DOMAttr</a>, <a class="el" href="classDOMEntity.html">DOMEntity</a>, <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a>, <a class="el" href="classDOMNotation.html">DOMNotation</a>, <a class="el" href="classDOMDocument.html">DOMDocument</a>, or <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> node.</td></tr>
1303</table>
1304</dl><dl compact><dt><b>
1305Since: </b><dd>
1306DOM Level 2 </dl>    </td>
1307  </tr>
1308</table>
1309<a name="z147_22" doxytag="DOMRange::toString"></a><p>
1310<table width="100%" cellpadding="2" cellspacing="0" border="0">
1311  <tr>
1312    <td class="md">
1313      <table cellpadding="0" cellspacing="0" border="0">
1314        <tr>
1315          <td class="md" nowrap valign="top"> virtual const XMLCh* DOMRange::toString </td>
1316          <td class="md" valign="top">(&nbsp;</td>
1317          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1318          <td class="md" valign="top">)&nbsp;</td>
1319          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1320        </tr>
1321
1322      </table>
1323    </td>
1324  </tr>
1325</table>
1326<table cellspacing=5 cellpadding=0 border=0>
1327  <tr>
1328    <td>
1329      &nbsp;
1330    </td>
1331    <td>
1332
1333<p>
1334Returns the contents of a Range as a string.
1335<p>
1336This string contains only the data characters, not any markup. <dl compact><dt><b>
1337Returns: </b><dd>
1338The contents of the Range. </dl><dl compact><dt><b>
1339Exceptions: </b><dd>
1340<table border=0 cellspacing=2 cellpadding=0>
1341<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1342 INVALID_STATE_ERR: Raised if <code><a class="el" href="classDOMRange.html#z147_23">detach</a>()</code> has already been invoked on this object.</td></tr>
1343</table>
1344</dl><dl compact><dt><b>
1345Since: </b><dd>
1346DOM Level 2 </dl>    </td>
1347  </tr>
1348</table>
1349<hr>The documentation for this class was generated from the following file:<ul>
1350<li><a class="el" href="DOMRange_8hpp-source.html">DOMRange.hpp</a></ul>
1351    </FONT></TD></TR></TABLE><BR>
1352</TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1" alt=""></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
1353              Copyright &copy; 1994-2004 The Apache Software Foundation.
1354              All Rights Reserved.
1355            </I></FONT></TD></TR></TABLE></BODY></HTML>
Note: See TracBrowser for help on using the repository browser.