uTools-Manuals/docs/java/org/w3c/dom/CharacterData.html

348 lines
21 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact2, compact3
</div>
<div class="subTitle">
org.w3c.dom
</div>
<h2 class="title" title="Interface CharacterData">Interface CharacterData</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Superinterfaces:
</dt>
<dd>
<span><a href="../../../org/w3c/dom/Node.html" title="界面在org.w3c.dom">Node</a></span>
</dd>
</dl>
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../../org/w3c/dom/CDATASection.html" title="界面在org.w3c.dom">CDATASection</a> <a href="../../../org/w3c/dom/Comment.html" title="界面在org.w3c.dom">Comment</a> <a href="../../../org/w3c/dom/Text.html" title="界面在org.w3c.dom">Text</a> <a href="../../../javax/xml/soap/Text.html" title="javax.xml.soap中的接口">Text</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">CharacterData</span>
extends <a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></pre>
<div class="block">
<span><code>CharacterData</code>接口使用一组用于访问DOM中的字符数据的属性和方法来扩展Node。</span>
<span>为了清楚起见,这个集合是在这里定义的,而不是使用这些属性和方法的每个对象。</span>
<span>没有DOM对象直接对应于<code>CharacterData</code> ,尽管<code>Text</code>和其他人确实从它继承了接口。</span>
<span>全部<code>offsets</code>在此界面从<code>0</code>开始。</span>
<p> <span>如DOMString <code>DOMString</code>所述DOM中的文本字符串以UTF-16表示即以16位为单位。</span> <span>在下文中术语16位单位在需要时使用表示CharacterData的索引以16位为单位完成。</span> </p>
<p> <span>另见<a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407">Document Object Model (DOM) Level 3 Core Specification</a></span> </p>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Fields inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <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></li>
</ul> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/CharacterData.html#appendData-java.lang.String-">appendData</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> arg)</code>
<div class="block">
将字符串附加到节点的字符数据的末尾。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/CharacterData.html#deleteData-int-int-">deleteData</a></span>(int offset, int count)</code>
<div class="block">
从节点中删除一个16位的单位范围。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/CharacterData.html#getData--">getData</a></span>()</code>
<div class="block">
实现此接口的节点的字符数据。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/CharacterData.html#getLength--">getLength</a></span>()</code>
<div class="block">
通过
<code>data</code>的16位单元
<code>data</code>和下面的
<code>substringData</code>方法。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/CharacterData.html#insertData-int-java.lang.String-">insertData</a></span>(int offset, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> arg)</code>
<div class="block">
以指定的16位单位偏移量插入字符串。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/CharacterData.html#replaceData-int-int-java.lang.String-">replaceData</a></span>(int offset, int count, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> arg)</code>
<div class="block">
用指定的字符串替换从指定的16位单位偏移开始的字符。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/CharacterData.html#setData-java.lang.String-">setData</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)</code>
<div class="block">
实现此接口的节点的字符数据。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/CharacterData.html#substringData-int-int-">substringData</a></span>(int offset, int count)</code>
<div class="block">
从节点中提取一系列数据。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <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></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getData--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getData</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getData()
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>实现此接口的节点的字符数据。</span>
<span>DOM实现可能不会对可能存储在<code>CharacterData</code>节点中的数据量进行任意限制。</span>
<span>然而,实施限制可能意味着节点数据的整体可能不适合单个<code>DOMString</code></span>
<span>在这种情况下,用户可以调用<code>substringData</code>以适当大小的片段检索数据。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - DOMSTRING_SIZE_ERR在实现平台上返回更多的字符而不是匹配
<code>DOMString</code>变量时引发。
</dd>
</dl> </li>
</ul> <a name="setData-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setData</h4> <pre>void setData(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>实现此接口的节点的字符数据。</span>
<span>DOM实现可能不会对可能存储在<code>CharacterData</code>节点中的数据量进行任意限制。</span>
<span>然而,实施限制可能意味着节点数据的整体可能不适合单个<code>DOMString</code></span>
<span>在这种情况下,用户可以调用<code>substringData</code>以适当大小的片段检索数据。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NO_MODIFICATION_ALLOWED_ERR当节点只读时引发。
</dd>
</dl> </li>
</ul> <a name="getLength--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLength</h4> <pre>int getLength()</pre>
<div class="block">
<span>通过<code>data</code>的16位单位<code>data</code>和下面的<code>substringData</code>方法。</span>
<span>这可能具有零值,即<code>CharacterData</code>节点可能为空。</span>
</div> </li>
</ul> <a name="substringData-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>substringData</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> substringData(int offset,
int count)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
从节点中提取一系列数据。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>offset</code> - 要提取的子字符串的起始偏移量。
</dd>
<dd>
<code>count</code> - 要提取的16位单位数。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>指定的子字符串。</span>
<span>如果<code>offset</code><code>count</code>的总和超过<code>length</code> 则返回到数据结尾的所有16位单元。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INDEX_SIZE_ERR如果指定的<code>offset</code>为负值或大于<code>offset</code>中的16位单元<code>data</code> ,或指定的<code>count</code>为负值则提升。</span>
<br/>
<span>DOMSTRING_SIZE_ERR如果指定的文本范围不适用于<code>DOMString</code><code>DOMString</code></span>
</dd>
</dl> </li>
</ul> <a name="appendData-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>appendData</h4> <pre>void appendData(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> arg)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>将字符串附加到节点的字符数据的末尾。</span>
<span>成功后, <code>data</code>提供访问指定的<code>data</code><code>DOMString</code>连接。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>arg</code> - 附加的
<code>DOMString</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NO_MODIFICATION_ALLOWED_ERR如果此节点是只读的则引发。
</dd>
</dl> </li>
</ul> <a name="insertData-int-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>insertData</h4> <pre>void insertData(int offset,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> arg)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
以指定的16位单位偏移量插入字符串。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>offset</code> - 要插入的字符偏移量。
</dd>
<dd>
<code>arg</code> - 要插入的
<code>DOMString</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INDEX_SIZE_ERR如果指定的<code>offset</code>为负值或大于<code>offset</code>中的16位单元数<code>data</code></span>
<br/>
<span>NO_MODIFICATION_ALLOWED_ERR如果此节点是只读的则引发。</span>
</dd>
</dl> </li>
</ul> <a name="deleteData-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>deleteData</h4> <pre>void deleteData(int offset,
int count)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>从节点中删除一个16位的单位范围。</span>
<span>成功后, <code>data</code><code>length</code>反映了变化。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>offset</code> - 从中开始删除的偏移量。
</dd>
<dd>
<span><code>count</code> - 要删除的16位单位数。</span>
<span>如果<code>offset</code><code>count</code>的总和超过<code>length</code> ,则从<code>offset</code>到数据结尾的所有16位单元都被删除。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INDEX_SIZE_ERR如果指定的<code>offset</code>为负值或大于<code>offset</code>中的16位单元<code>data</code> ,或指定的<code>count</code>为负,则提升。</span>
<br/>
<span>NO_MODIFICATION_ALLOWED_ERR如果此节点是只读的则引发。</span>
</dd>
</dl> </li>
</ul> <a name="replaceData-int-int-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>replaceData</h4> <pre>void replaceData(int offset,
int count,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> arg)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
用指定的字符串替换从指定的16位单位偏移开始的字符。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>offset</code> - 开始替换的偏移量。
</dd>
<dd>
<span><code>count</code> - 要替换的16位单位数。</span>
<span>如果<code>offset</code><code>count</code>的总和超过<code>length</code> 则所有16位单位到数据结尾都被替换;</span>
<span>(即效果与具有相同范围的<code>remove</code>方法调用相同,后跟<code>append</code>方法调用)。</span>
</dd>
<dd>
<code>arg</code> - 必须更换范围的
<code>DOMString</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INDEX_SIZE_ERR: Raised if the specified
<code>offset</code> is negative or greater than the number of 16-bit units in
<code>data</code>, or if the specified
<code>count</code> is negative.
<br/>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>