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

247 lines
9.4 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 UserDataHandler">Interface UserDataHandler</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public interface <span class="typeNameLabel">UserDataHandler</span></pre>
<div class="block">
<span>当使用Node.setUserData()将对象与节点上的密钥<code>Node.setUserData()</code> ,应用程序可以提供一个处理程序,当对象被关联到的节点被克隆,导入或重命名时,该处理程序将被调用。</span>
<span>应用程序可以使用它来实现与DOM节点关联的数据的各种行为。</span>
<span>此接口定义该处理程序。</span>
<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>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
DOM 3级
</dd>
</dl> </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>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static short</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/UserDataHandler.html#NODE_ADOPTED">NODE_ADOPTED</a></span></code>
<div class="block">
采用节点,采用
<code>Document.adoptNode()</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static short</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/UserDataHandler.html#NODE_CLONED">NODE_CLONED</a></span></code>
<div class="block">
该节点被克隆,使用
<code>Node.cloneNode()</code>
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static short</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/UserDataHandler.html#NODE_DELETED">NODE_DELETED</a></span></code>
<div class="block">
节点被删除。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static short</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/UserDataHandler.html#NODE_IMPORTED">NODE_IMPORTED</a></span></code>
<div class="block">
节点被导入,使用
<code>Document.importNode()</code>
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static short</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/UserDataHandler.html#NODE_RENAMED">NODE_RENAMED</a></span></code>
<div class="block">
节点被重命名,使用
<code>Document.renameNode()</code>
</div> </td>
</tr>
</tbody>
</table> </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/UserDataHandler.html#handle-short-java.lang.String-java.lang.Object-org.w3c.dom.Node-org.w3c.dom.Node-">handle</a></span>(short operation, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> key, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> data, <a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> src, <a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> dst)</code>
<div class="block">
每当注册此处理程序的节点被导入或克隆时,都会调用此方法。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="NODE_CLONED">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>NODE_CLONED</h4> <pre>static final short NODE_CLONED</pre>
<div class="block">
该节点被克隆,使用
<code>Node.cloneNode()</code>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#org.w3c.dom.UserDataHandler.NODE_CLONED">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="NODE_IMPORTED">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>NODE_IMPORTED</h4> <pre>static final short NODE_IMPORTED</pre>
<div class="block">
导入节点,使用
<code>Document.importNode()</code>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#org.w3c.dom.UserDataHandler.NODE_IMPORTED">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="NODE_DELETED">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>NODE_DELETED</h4> <pre>static final short NODE_DELETED</pre>
<div class="block">
<span>节点被删除。</span>
<p> <span><b>注意:</b>这在某些环境中可能不受支持或可能不可靠例如Java其中实现对实际删除对象无实际控制。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#org.w3c.dom.UserDataHandler.NODE_DELETED">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="NODE_RENAMED">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>NODE_RENAMED</h4> <pre>static final short NODE_RENAMED</pre>
<div class="block">
该节点被重命名,使用
<code>Document.renameNode()</code>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#org.w3c.dom.UserDataHandler.NODE_RENAMED">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="NODE_ADOPTED">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>NODE_ADOPTED</h4> <pre>static final short NODE_ADOPTED</pre>
<div class="block">
采用节点,采用
<code>Document.adoptNode()</code>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#org.w3c.dom.UserDataHandler.NODE_ADOPTED">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="handle-short-java.lang.String-java.lang.Object-org.w3c.dom.Node-org.w3c.dom.Node-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>handle</h4> <pre>void handle(short operation,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> key,
<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> data,
<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> src,
<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> dst)</pre>
<div class="block">
<span>每当注册此处理程序的节点被导入或克隆时,都会调用此方法。</span>
<br/>
<span>DOM应用程序不能在UserDataHandler中<code>UserDataHandler</code></span>
<span>从处理程序中抛出异常的效果是依赖于DOM实现的。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>operation</code> - 指定在节点上执行的操作类型。
</dd>
<dd>
<code>key</code> - 指定要调用此处理程序的键。
</dd>
<dd>
<code>data</code> - 指定正在调用此处理程序的数据。
</dd>
<dd>
<span><code>src</code> - 指定要克隆,采用,导入或重命名的节点。</span>
<span>当节点被删除时,这是<code>null</code></span>
</dd>
<dd>
<code>dst</code> - 指定新创建的节点,如果有的话,或
<code>null</code>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>