| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
|
| <!--NewPage-->
|
| <HTML>
|
| <HEAD>
|
| <!-- Generated by javadoc on Thu Nov 22 17:12:59 EST 2007 -->
|
| <TITLE>
|
| Xalan-Java 2.7.1: Interface Text
|
| </TITLE>
|
| <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
|
| </HEAD>
|
| <BODY BGCOLOR="white">
|
|
|
| <!-- ========== START OF NAVBAR ========== -->
|
| <A NAME="navbar_top"><!-- --></A> |
| <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
|
| <TR>
|
| <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
|
| <A NAME="navbar_top_firstrow"><!-- --></A> |
| <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
|
| <TR ALIGN="center" VALIGN="top">
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
|
| <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/Text.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
|
| </TR>
|
| </TABLE>
|
| </TD>
|
| <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
|
| </EM>
|
| </TD>
|
| </TR>
|
|
|
| <TR>
|
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
| <A HREF="../../../org/w3c/dom/ProcessingInstruction.html"><B>PREV CLASS</B></A>
|
| <A HREF="../../../org/w3c/dom/TypeInfo.html"><B>NEXT CLASS</B></A></FONT></TD>
|
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
| <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
|
| <A HREF="Text.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
|
| </TR>
|
| <TR>
|
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
| SUMMARY: INNER | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
|
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
| DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
|
| </TR>
|
| </TABLE>
|
| <!-- =========== END OF NAVBAR =========== -->
|
|
|
| <HR>
|
| <!-- ======== START OF CLASS DATA ======== -->
|
| <H2>
|
| <FONT SIZE="-1">
|
| org.w3c.dom</FONT>
|
| <BR>
|
| Interface Text</H2>
|
| <DL>
|
| <DT><B>All Known Subinterfaces:</B> <DD><A HREF="../../../org/w3c/dom/CDATASection.html">CDATASection</A></DD>
|
| </DL>
|
| <DL>
|
| <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../org/apache/xml/dtm/ref/DTMNodeProxy.html">DTMNodeProxy</A></DD>
|
| </DL>
|
| <HR>
|
| <DL>
|
| <DT>public interface <B>Text</B><DT>extends <A HREF="../../../org/w3c/dom/CharacterData.html">CharacterData</A></DL>
|
|
|
| <P>
|
| The <code>Text</code> interface inherits from <code>CharacterData</code> |
| and represents the textual content (termed <a href='http://www.w3.org/TR/2004/REC-xml-20040204#syntax'>character data</a> in XML) of an <code>Element</code> or <code>Attr</code>. If there is no |
| markup inside an element's content, the text is contained in a single |
| object implementing the <code>Text</code> interface that is the only |
| child of the element. If there is markup, it is parsed into the |
| information items (elements, comments, etc.) and <code>Text</code> nodes |
| that form the list of children of the element. |
| <p>When a document is first made available via the DOM, there is only one |
| <code>Text</code> node for each block of text. Users may create adjacent |
| <code>Text</code> nodes that represent the contents of a given element |
| without any intervening markup, but should be aware that there is no way |
| to represent the separations between these nodes in XML or HTML, so they |
| will not (in general) persist between DOM editing sessions. The |
| <code>Node.normalize()</code> method merges any such adjacent |
| <code>Text</code> objects into a single node for each block of text. |
| <p> No lexical check is done on the content of a <code>Text</code> node |
| and, depending on its position in the document, some characters must be |
| escaped during serialization using character references; e.g. the |
| characters "<&" if the textual content is part of an element or of |
| an attribute, the character sequence "]]>" when part of an element, |
| the quotation mark character " or the apostrophe character ' when part of |
| an attribute. |
| <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
|
| <P>
|
| <HR>
|
|
|
| <P>
|
| <!-- ======== INNER CLASS SUMMARY ======== -->
|
|
|
|
|
| <!-- =========== FIELD SUMMARY =========== -->
|
|
|
| <A NAME="fields_inherited_from_class_org.w3c.dom.Node"><!-- --></A> |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
|
| <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
|
| <TD><B>Fields inherited from class org.w3c.dom.<A HREF="../../../org/w3c/dom/Node.html">Node</A></B></TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD><CODE><A HREF="../../../org/w3c/dom/Node.html#ATTRIBUTE_NODE">ATTRIBUTE_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#CDATA_SECTION_NODE">CDATA_SECTION_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#COMMENT_NODE">COMMENT_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_FRAGMENT_NODE">DOCUMENT_FRAGMENT_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_NODE">DOCUMENT_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINED_BY">DOCUMENT_POSITION_CONTAINED_BY</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINS">DOCUMENT_POSITION_CONTAINS</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_DISCONNECTED">DOCUMENT_POSITION_DISCONNECTED</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_FOLLOWING">DOCUMENT_POSITION_FOLLOWING</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC">DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_PRECEDING">DOCUMENT_POSITION_PRECEDING</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#DOCUMENT_TYPE_NODE">DOCUMENT_TYPE_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#ELEMENT_NODE">ELEMENT_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#ENTITY_NODE">ENTITY_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#ENTITY_REFERENCE_NODE">ENTITY_REFERENCE_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#NOTATION_NODE">NOTATION_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#PROCESSING_INSTRUCTION_NODE">PROCESSING_INSTRUCTION_NODE</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#TEXT_NODE">TEXT_NODE</A></CODE></TD>
|
| </TR>
|
| </TABLE>
|
|
|
| <!-- ======== CONSTRUCTOR SUMMARY ======== -->
|
|
|
|
|
| <!-- ========== METHOD SUMMARY =========== -->
|
|
|
| <A NAME="method_summary"><!-- --></A> |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
|
| <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
|
| <TD COLSPAN=2><FONT SIZE="+2">
|
| <B>Method Summary</B></FONT></TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> java.lang.String</CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../org/w3c/dom/Text.html#getWholeText()">getWholeText</A></B>()</CODE>
|
|
|
| <BR>
|
| Returns all text of <code>Text</code> nodes logically-adjacent text |
| nodes to this node, concatenated in document order.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> boolean</CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../org/w3c/dom/Text.html#isElementContentWhitespace()">isElementContentWhitespace</A></B>()</CODE>
|
|
|
| <BR>
|
| Returns whether this text node contains <a href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204#infoitem.character'> |
| element content whitespace</a>, often abusively called "ignorable whitespace".</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> <A HREF="../../../org/w3c/dom/Text.html">Text</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../org/w3c/dom/Text.html#replaceWholeText(java.lang.String)">replaceWholeText</A></B>(java.lang.String content)</CODE>
|
|
|
| <BR>
|
| Replaces the text of the current node and all logically-adjacent text |
| nodes with the specified text.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> <A HREF="../../../org/w3c/dom/Text.html">Text</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../org/w3c/dom/Text.html#splitText(int)">splitText</A></B>(int offset)</CODE>
|
|
|
| <BR>
|
| Breaks this node into two nodes at the specified <code>offset</code>, |
| keeping both in the tree as siblings.</TD>
|
| </TR>
|
| </TABLE>
|
| <A NAME="methods_inherited_from_class_org.w3c.dom.CharacterData"><!-- --></A> |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
|
| <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
|
| <TD><B>Methods inherited from interface org.w3c.dom.<A HREF="../../../org/w3c/dom/CharacterData.html">CharacterData</A></B></TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD><CODE><A HREF="../../../org/w3c/dom/CharacterData.html#appendData(java.lang.String)">appendData</A>,
|
| <A HREF="../../../org/w3c/dom/CharacterData.html#deleteData(int, int)">deleteData</A>,
|
| <A HREF="../../../org/w3c/dom/CharacterData.html#getData()">getData</A>,
|
| <A HREF="../../../org/w3c/dom/CharacterData.html#getLength()">getLength</A>,
|
| <A HREF="../../../org/w3c/dom/CharacterData.html#insertData(int, java.lang.String)">insertData</A>,
|
| <A HREF="../../../org/w3c/dom/CharacterData.html#replaceData(int, int, java.lang.String)">replaceData</A>,
|
| <A HREF="../../../org/w3c/dom/CharacterData.html#setData(java.lang.String)">setData</A>,
|
| <A HREF="../../../org/w3c/dom/CharacterData.html#substringData(int, int)">substringData</A></CODE></TD>
|
| </TR>
|
| </TABLE>
|
| <A NAME="methods_inherited_from_class_org.w3c.dom.Node"><!-- --></A> |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
|
| <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
|
| <TD><B>Methods inherited from interface org.w3c.dom.<A HREF="../../../org/w3c/dom/Node.html">Node</A></B></TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD><CODE><A HREF="../../../org/w3c/dom/Node.html#appendChild(org.w3c.dom.Node)">appendChild</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#cloneNode(boolean)">cloneNode</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#compareDocumentPosition(org.w3c.dom.Node)">compareDocumentPosition</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getAttributes()">getAttributes</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getBaseURI()">getBaseURI</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getChildNodes()">getChildNodes</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getFeature(java.lang.String, java.lang.String)">getFeature</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getFirstChild()">getFirstChild</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getLastChild()">getLastChild</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getLocalName()">getLocalName</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getNamespaceURI()">getNamespaceURI</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getNextSibling()">getNextSibling</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getNodeName()">getNodeName</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getNodeType()">getNodeType</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getNodeValue()">getNodeValue</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getOwnerDocument()">getOwnerDocument</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getParentNode()">getParentNode</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getPrefix()">getPrefix</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getPreviousSibling()">getPreviousSibling</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getTextContent()">getTextContent</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#getUserData(java.lang.String)">getUserData</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#hasAttributes()">hasAttributes</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#hasChildNodes()">hasChildNodes</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#insertBefore(org.w3c.dom.Node, org.w3c.dom.Node)">insertBefore</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#isDefaultNamespace(java.lang.String)">isDefaultNamespace</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#isEqualNode(org.w3c.dom.Node)">isEqualNode</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#isSameNode(org.w3c.dom.Node)">isSameNode</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#isSupported(java.lang.String, java.lang.String)">isSupported</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#lookupNamespaceURI(java.lang.String)">lookupNamespaceURI</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#lookupPrefix(java.lang.String)">lookupPrefix</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#normalize()">normalize</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#removeChild(org.w3c.dom.Node)">removeChild</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#replaceChild(org.w3c.dom.Node, org.w3c.dom.Node)">replaceChild</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#setNodeValue(java.lang.String)">setNodeValue</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#setPrefix(java.lang.String)">setPrefix</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#setTextContent(java.lang.String)">setTextContent</A>,
|
| <A HREF="../../../org/w3c/dom/Node.html#setUserData(java.lang.String, java.lang.Object, org.w3c.dom.UserDataHandler)">setUserData</A></CODE></TD>
|
| </TR>
|
| </TABLE>
|
|
|
| <P>
|
|
|
| <!-- ============ FIELD DETAIL =========== -->
|
|
|
|
|
| <!-- ========= CONSTRUCTOR DETAIL ======== -->
|
|
|
|
|
| <!-- ============ METHOD DETAIL ========== -->
|
|
|
| <A NAME="method_detail"><!-- --></A> |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
|
| <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
|
| <TD COLSPAN=1><FONT SIZE="+2">
|
| <B>Method Detail</B></FONT></TD>
|
| </TR>
|
| </TABLE>
|
|
|
| <A NAME="splitText(int)"><!-- --></A><H3>
|
| splitText</H3>
|
| <PRE>
|
| public <A HREF="../../../org/w3c/dom/Text.html">Text</A> <B>splitText</B>(int offset) |
| throws <A HREF="../../../org/w3c/dom/DOMException.html">DOMException</A></PRE>
|
| <DL>
|
| <DD>Breaks this node into two nodes at the specified <code>offset</code>, |
| keeping both in the tree as siblings. After being split, this node |
| will contain all the content up to the <code>offset</code> point. A |
| new node of the same type, which contains all the content at and |
| after the <code>offset</code> point, is returned. If the original |
| node had a parent node, the new node is inserted as the next sibling |
| of the original node. When the <code>offset</code> is equal to the |
| length of this node, the new node has no data.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>offset</CODE> - The 16-bit unit offset at which to split, starting from |
| <code>0</code>.<DT><B>Returns:</B><DD>The new node, of the same type as this node.<DT><B>Throws:</B><DD><A HREF="../../../org/w3c/dom/DOMException.html">DOMException</A> - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater |
| than the number of 16-bit units in <code>data</code>. |
| <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.</DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="isElementContentWhitespace()"><!-- --></A><H3>
|
| isElementContentWhitespace</H3>
|
| <PRE>
|
| public boolean <B>isElementContentWhitespace</B>()</PRE>
|
| <DL>
|
| <DD>Returns whether this text node contains <a href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204#infoitem.character'> |
| element content whitespace</a>, often abusively called "ignorable whitespace". The text node is |
| determined to contain whitespace in element content during the load |
| of the document or if validation occurs while using |
| <code>Document.normalizeDocument()</code>.<DD><DL>
|
| <DT><B>Since: </B><DD>DOM Level 3</DD>
|
| </DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="getWholeText()"><!-- --></A><H3>
|
| getWholeText</H3>
|
| <PRE>
|
| public java.lang.String <B>getWholeText</B>()</PRE>
|
| <DL>
|
| <DD>Returns all text of <code>Text</code> nodes logically-adjacent text |
| nodes to this node, concatenated in document order. |
| <br>For instance, in the example below <code>wholeText</code> on the |
| <code>Text</code> node that contains "bar" returns "barfoo", while on |
| the <code>Text</code> node that contains "foo" it returns "barfoo".<DD><DL>
|
| <DT><B>Since: </B><DD>DOM Level 3</DD>
|
| </DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="replaceWholeText(java.lang.String)"><!-- --></A><H3>
|
| replaceWholeText</H3>
|
| <PRE>
|
| public <A HREF="../../../org/w3c/dom/Text.html">Text</A> <B>replaceWholeText</B>(java.lang.String content) |
| throws <A HREF="../../../org/w3c/dom/DOMException.html">DOMException</A></PRE>
|
| <DL>
|
| <DD>Replaces the text of the current node and all logically-adjacent text |
| nodes with the specified text. All logically-adjacent text nodes are |
| removed including the current node unless it was the recipient of the |
| replacement text. |
| <br>This method returns the node which received the replacement text. |
| The returned node is: |
| <ul> |
| <li><code>null</code>, when the replacement text is |
| the empty string; |
| </li> |
| <li>the current node, except when the current node is |
| read-only; |
| </li> |
| <li> a new <code>Text</code> node of the same type ( |
| <code>Text</code> or <code>CDATASection</code>) as the current node |
| inserted at the location of the replacement. |
| </li> |
| </ul> |
| <br>For instance, in the above example calling |
| <code>replaceWholeText</code> on the <code>Text</code> node that |
| contains "bar" with "yo" in argument results in the following: |
| <br>Where the nodes to be removed are read-only descendants of an |
| <code>EntityReference</code>, the <code>EntityReference</code> must |
| be removed instead of the read-only nodes. If any |
| <code>EntityReference</code> to be removed has descendants that are |
| not <code>EntityReference</code>, <code>Text</code>, or |
| <code>CDATASection</code> nodes, the <code>replaceWholeText</code> |
| method must fail before performing any modification of the document, |
| raising a <code>DOMException</code> with the code |
| <code>NO_MODIFICATION_ALLOWED_ERR</code>. |
| <br>For instance, in the example below calling |
| <code>replaceWholeText</code> on the <code>Text</code> node that |
| contains "bar" fails, because the <code>EntityReference</code> node |
| "ent" contains an <code>Element</code> node which cannot be removed.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>content</CODE> - The content of the replacing <code>Text</code> node.<DT><B>Returns:</B><DD>The <code>Text</code> node created with the specified content.<DT><B>Throws:</B><DD><A HREF="../../../org/w3c/dom/DOMException.html">DOMException</A> - NO_MODIFICATION_ALLOWED_ERR: Raised if one of the <code>Text</code> |
| nodes being replaced is readonly.<DT><B>Since: </B><DD>DOM Level 3</DD>
|
| </DL>
|
| </DD>
|
| </DL>
|
| <!-- ========= END OF CLASS DATA ========= -->
|
| <HR>
|
|
|
| <!-- ========== START OF NAVBAR ========== -->
|
| <A NAME="navbar_bottom"><!-- --></A> |
| <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
|
| <TR>
|
| <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
|
| <A NAME="navbar_bottom_firstrow"><!-- --></A> |
| <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
|
| <TR ALIGN="center" VALIGN="top">
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
|
| <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/Text.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
|
| </TR>
|
| </TABLE>
|
| </TD>
|
| <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
|
| </EM>
|
| </TD>
|
| </TR>
|
|
|
| <TR>
|
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
| <A HREF="../../../org/w3c/dom/ProcessingInstruction.html"><B>PREV CLASS</B></A>
|
| <A HREF="../../../org/w3c/dom/TypeInfo.html"><B>NEXT CLASS</B></A></FONT></TD>
|
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
| <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
|
| <A HREF="Text.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
|
| </TR>
|
| <TR>
|
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
| SUMMARY: INNER | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
|
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
| DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
|
| </TR>
|
| </TABLE>
|
| <!-- =========== END OF NAVBAR =========== -->
|
|
|
| <HR>
|
| Copyright © 2006 Apache XML Project. All Rights Reserved.
|
| </BODY>
|
| </HTML>
|