uTools-Manuals/docs/java/org/w3c/dom/events/EventTarget.html

<div class="header">
<div class="subTitle">
     compact2, compact3 
   </div>
<div class="subTitle">
     org.w3c.dom.events 
   </div>
<h2 class="title" title="Interface EventTarget">Interface EventTarget</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public interface <span class="typeNameLabel">EventTarget</span></pre>
<div class="block">
<span><code>EventTarget</code>接口由支持DOM事件模型的<code>Nodes</code>中的所有<code>Nodes</code>实现。</span>
<span>因此，可以通过在<code>Node</code>接口的实例上使用绑定特定的转换方法来获得此接口。</span>
<span>该界面允许在<code>EventListeners</code>上注册和删除<code>EventTarget</code>并将事件发送到该<code>EventTarget</code> 。</span>
<p> <span>另见<a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113">Document Object Model (DOM) Level 2 Events Specification</a> 。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         DOM级别2 
       </dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== 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/events/EventTarget.html#addEventListener-java.lang.String-org.w3c.dom.events.EventListener-boolean-">addEventListener</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> type, <a href="../../../../org/w3c/dom/events/EventListener.html" title="interface in org.w3c.dom.events">EventListener</a> listener, boolean useCapture)</code>
<div class="block">
              该方法允许在事件目标上注册事件侦听器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/EventTarget.html#dispatchEvent-org.w3c.dom.events.Event-">dispatchEvent</a></span>(<a href="../../../../org/w3c/dom/events/Event.html" title="interface in org.w3c.dom.events">Event</a> evt)</code>
<div class="block">
              该方法允许将事件分派到实现事件模型中。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/EventTarget.html#removeEventListener-java.lang.String-org.w3c.dom.events.EventListener-boolean-">removeEventListener</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> type, <a href="../../../../org/w3c/dom/events/EventListener.html" title="interface in org.w3c.dom.events">EventListener</a> listener, boolean useCapture)</code>
<div class="block">
              此方法允许从事件目标中删除事件侦听器。 
            </div> </td>
</tr>
</tbody>
</table> </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="addEventListener-java.lang.String-org.w3c.dom.events.EventListener-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addEventListener</h4> <pre>void addEventListener(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> type,
                      <a href="../../../../org/w3c/dom/events/EventListener.html" title="interface in org.w3c.dom.events">EventListener</a> listener,
                      boolean useCapture)</pre>
<div class="block">
<span>该方法允许在事件目标上注册事件侦听器。</span>
<span>如果<code>EventListener</code>被添加到<code>EventTarget</code>时它正在处理一个事件，它不会被通过当前操作触发，而是可以在事件流，的稍后阶段如冒泡阶段被触发。</span>
<br/>
<span>如果多个相同<code>EventListener</code> s的注册在同一<code>EventTarget</code>具有相同参数的重复的实例被丢弃。</span>
<span>它们不会导致<code>EventListener</code>被调用两次，并且由于它们被丢弃，所以不需要使用<code>removeEventListener</code>方法删除它们。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>type</code> - 用户正在注册的事件类型 
           </dd>
<dd>
<code>listener</code> - 
            <code>listener</code>参数采用由用户实现的接口，该接口包含事件发生时要调用的方法。 
           </dd>
<dd>
<span><code>useCapture</code> - 如果为真， <code>useCapture</code>表示用户希望启动捕获。</span>
<span>启动捕获后，指定类型的所有事件将被发送到注册的<code>EventListener</code>然后再将其发送到树下的任何<code>EventTargets</code> 。</span>
<span>通过树上冒泡的事件不会触发指定使用捕获的<code>EventListener</code> 。</span>
</dd>
</dl> </li>
</ul> <a name="removeEventListener-java.lang.String-org.w3c.dom.events.EventListener-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeEventListener</h4> <pre>void removeEventListener(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> type,
                         <a href="../../../../org/w3c/dom/events/EventListener.html" title="interface in org.w3c.dom.events">EventListener</a> listener,
                         boolean useCapture)</pre>
<div class="block">
<span>此方法允许从事件目标中删除事件侦听器。</span>
<span>如果<code>EventListener</code>是从去除<code>EventTarget</code>时它正在处理一个事件，它不会由当前操作触发。</span>
<span><code>EventListener</code>被删除后永远不会被调用。</span>
<br/>
<span>拨打<code>removeEventListener</code>的参数不会识别EventTarget当前<code>EventListener</code>的<code>EventTarget</code>没有任何效果。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>type</code> -指定的事件类型 
            <code>EventListener</code>被删除。 
           </dd>
<dd>
<code>listener</code> - 
            <code>EventListener</code>参数表示要删除的 
            <code>EventListener</code> 。 
           </dd>
<dd>
<span><code>useCapture</code> -指定是否<code>EventListener</code>被删除被注册为捕捉听者与否。</span>
<span>如果一个监听器被注册了两次，一个被捕获，一个没有，每个都必须被单独删除。</span>
<span>删除捕获侦听器不会影响同一侦听器的非捕获版本，反之亦然。</span>
</dd>
</dl> </li>
</ul> <a name="dispatchEvent-org.w3c.dom.events.Event-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>dispatchEvent</h4> <pre>boolean dispatchEvent(<a href="../../../../org/w3c/dom/events/Event.html" title="interface in org.w3c.dom.events">Event</a> evt)
               throws <a href="../../../../org/w3c/dom/events/EventException.html" title="class in org.w3c.dom.events">EventException</a></pre>
<div class="block">
<span>该方法允许将事件分派到实现事件模型中。</span>
<span>以这种方式发送的事件将具有与实现直接发送的事件相同的捕获和冒泡行为。</span>
<span>该事件的目标是<code>EventTarget</code>上<code>dispatchEvent</code>被调用。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>evt</code> - 指定用于处理事件的事件类型，行为和上下文信息。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span><code>dispatchEvent</code>的返回值<code>dispatchEvent</code>处理事件的任何<code>dispatchEvent</code>器是否为<code>preventDefault</code> 。</span>
<span>如果<code>preventDefault</code>被称为值为false，否则该值为true。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../org/w3c/dom/events/EventException.html" title="class in org.w3c.dom.events">EventException</a></code> - UNSPECIFIED_EVENT_TYPE_ERR：如果<code>Event</code>的类型未通过在<code>dispatchEvent</code>之前<code>dispatchEvent</code>事件指定，则引发。</span>
<span>所述的规范<code>Event</code>的类型为<code>null</code>或空字符串也会触发此异常。</span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>