mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-08 02:32:46 +08:00
348 lines
16 KiB
HTML
348 lines
16 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact2, compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
org.w3c.dom.events
|
||
</div>
|
||
<h2 class="title" title="Interface Event">Interface Event</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
All Known Subinterfaces:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../../org/w3c/dom/ls/LSLoadEvent.html" title="界面在org.w3c.dom.ls中">LSLoadEvent</a> ， <a href="../../../../org/w3c/dom/ls/LSProgressEvent.html" title="界面在org.w3c.dom.ls中">LSProgressEvent</a> ， <a href="../../../../org/w3c/dom/events/MouseEvent.html" title="界面在org.w3c.dom.events中">MouseEvent</a> ， <a href="../../../../org/w3c/dom/events/MutationEvent.html" title="界面在org.w3c.dom.events中">MutationEvent</a> ， <a href="../../../../org/w3c/dom/events/UIEvent.html" title="界面在org.w3c.dom.events中">UIEvent</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">Event</span></pre>
|
||
<div class="block">
|
||
<span><code>Event</code>接口用于向事件处理程序提供有关事件的上下文信息。</span>
|
||
<span>实现<code>Event</code>接口的对象通常作为第一个参数传递给事件处理程序。</span>
|
||
<span>更具体的上下文信息通过从<code>Event</code>导出附加接口传递给事件处理程序，其中包含与它们相关的事件类型直接相关的信息。</span>
|
||
<span>这些派生接口也由传递给事件侦听器的对象实现。</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">
|
||
<!-- =========== 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/events/Event.html#AT_TARGET">AT_TARGET</a></span></code>
|
||
<div class="block">
|
||
该事件目前正在目标
|
||
<code>EventTarget</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/events/Event.html#BUBBLING_PHASE">BUBBLING_PHASE</a></span></code>
|
||
<div class="block">
|
||
当前的事件阶段是冒泡阶段。
|
||
</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/events/Event.html#CAPTURING_PHASE">CAPTURING_PHASE</a></span></code>
|
||
<div class="block">
|
||
当前的事件阶段是捕获阶段。
|
||
</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>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/Event.html#getBubbles--">getBubbles</a></span>()</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/Event.html#getCancelable--">getCancelable</a></span>()</code>
|
||
<div class="block">
|
||
用于指示事件是否可以防止其默认动作。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code><a href="../../../../org/w3c/dom/events/EventTarget.html" title="interface in org.w3c.dom.events">EventTarget</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/Event.html#getCurrentTarget--">getCurrentTarget</a></span>()</code>
|
||
<div class="block">
|
||
用于指示
|
||
<code>EventTarget</code>其
|
||
<code>EventListeners</code> ，目前正在处理。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>short</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/Event.html#getEventPhase--">getEventPhase</a></span>()</code>
|
||
<div class="block">
|
||
用于指示当前正在评估事件流的哪个阶段。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code><a href="../../../../org/w3c/dom/events/EventTarget.html" title="interface in org.w3c.dom.events">EventTarget</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/Event.html#getTarget--">getTarget</a></span>()</code>
|
||
<div class="block">
|
||
用于指示
|
||
<code>EventTarget</code>到最初被分派的事件。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code>long</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/Event.html#getTimeStamp--">getTimeStamp</a></span>()</code>
|
||
<div class="block">
|
||
用于指定创建事件的时间（以秒为单位的毫秒）。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<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/events/Event.html#getType--">getType</a></span>()</code>
|
||
<div class="block">
|
||
事件的名称（不区分大小写）。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/Event.html#initEvent-java.lang.String-boolean-boolean-">initEvent</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> eventTypeArg, boolean canBubbleArg, boolean cancelableArg)</code>
|
||
<div class="block">
|
||
<code>initEvent</code>方法用于
|
||
<code>Event</code>通过
|
||
<code>Event</code>创建的
|
||
<code>DocumentEvent</code>值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i8">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/Event.html#preventDefault--">preventDefault</a></span>()</code>
|
||
<div class="block">
|
||
如果事件是可取消的，则使用
|
||
<code>preventDefault</code>方法来表示事件将被取消，这意味着由于事件而导致的实现中通常采取的任何默认操作都不会发生。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i9">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/events/Event.html#stopPropagation--">stopPropagation</a></span>()</code>
|
||
<div class="block">
|
||
<code>stopPropagation</code>方法用于防止在事件流中事件的进一步传播。
|
||
</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="CAPTURING_PHASE">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>CAPTURING_PHASE</h4> <pre>static final short CAPTURING_PHASE</pre>
|
||
<div class="block">
|
||
当前的事件阶段是捕获阶段。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../constant-values.html#org.w3c.dom.events.Event.CAPTURING_PHASE">Constant Field Values</a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="AT_TARGET">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>AT_TARGET</h4> <pre>static final short AT_TARGET</pre>
|
||
<div class="block">
|
||
目前正在对目标进行
|
||
<code>EventTarget</code> 。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../constant-values.html#org.w3c.dom.events.Event.AT_TARGET">Constant Field Values</a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="BUBBLING_PHASE">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>BUBBLING_PHASE</h4> <pre>static final short BUBBLING_PHASE</pre>
|
||
<div class="block">
|
||
当前的事件阶段是冒泡阶段。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../constant-values.html#org.w3c.dom.events.Event.BUBBLING_PHASE">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="getType--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getType</h4> <pre><a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getType()</pre>
|
||
<div class="block">
|
||
<span>事件的名称（不区分大小写）。</span>
|
||
<span>该名称必须是XML名称。</span>
|
||
</div> </li>
|
||
</ul> <a name="getTarget--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getTarget</h4> <pre><a href="../../../../org/w3c/dom/events/EventTarget.html" title="interface in org.w3c.dom.events">EventTarget</a> getTarget()</pre>
|
||
<div class="block">
|
||
用于指示
|
||
<code>EventTarget</code>到最初被分派的事件。
|
||
</div> </li>
|
||
</ul> <a name="getCurrentTarget--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getCurrentTarget</h4> <pre><a href="../../../../org/w3c/dom/events/EventTarget.html" title="interface in org.w3c.dom.events">EventTarget</a> getCurrentTarget()</pre>
|
||
<div class="block">
|
||
<span>用于指示<code>EventTarget</code>其<code>EventListeners</code> ，目前正在处理。</span>
|
||
<span>这在捕获和冒泡时特别有用。</span>
|
||
</div> </li>
|
||
</ul> <a name="getEventPhase--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getEventPhase</h4> <pre>short getEventPhase()</pre>
|
||
<div class="block">
|
||
用于指示当前正在评估事件流的哪个阶段。
|
||
</div> </li>
|
||
</ul> <a name="getBubbles--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getBubbles</h4> <pre>boolean getBubbles()</pre>
|
||
<div class="block">
|
||
<span>用于指示事件是否是冒泡事件。</span>
|
||
<span>如果事件可以浮动，则值为true，否则该值为false。</span>
|
||
</div> </li>
|
||
</ul> <a name="getCancelable--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getCancelable</h4> <pre>boolean getCancelable()</pre>
|
||
<div class="block">
|
||
<span>用于指示事件是否可以防止其默认动作。</span>
|
||
<span>如果可以防止缺省动作，则该值为true，否则该值为false。</span>
|
||
</div> </li>
|
||
</ul> <a name="getTimeStamp--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getTimeStamp</h4> <pre>long getTimeStamp()</pre>
|
||
<div class="block">
|
||
<span>用于指定创建事件的时间（以秒为单位的毫秒）。</span>
|
||
<span>由于这样的事实，有些系统不能提供此信息的价值<code>timeStamp</code>可能并不适用于所有的事件。</span>
|
||
<span>当不可用时，将返回值0。</span>
|
||
<span>时代的例子是系统启动的时间或1970年1月1日的0：0：0 UTC。</span>
|
||
</div> </li>
|
||
</ul> <a name="stopPropagation--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>stopPropagation</h4> <pre>void stopPropagation()</pre>
|
||
<div class="block">
|
||
<span><code>stopPropagation</code>方法用于防止事件流中事件的进一步传播。</span>
|
||
<span>如果这种方法被任何<code>EventListener</code> ，事件将停止通过树传播。</span>
|
||
<span>在事件流程停止之前，该事件将完成对当前<code>EventTarget</code>所有侦听器的调度。</span>
|
||
<span>该方法可以在事件流的任何阶段使用。</span>
|
||
</div> </li>
|
||
</ul> <a name="preventDefault--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>preventDefault</h4> <pre>void preventDefault()</pre>
|
||
<div class="block">
|
||
<span>如果事件是可取消的，则使用<code>preventDefault</code>方法来表示事件将被取消，这意味着由于事件而导致的实现中通常采取的任何默认操作都不会发生。</span>
|
||
<span>如果在事件流程的任何阶段， <code>preventDefault</code>方法称为事件被取消。</span>
|
||
<span>与事件关联的任何默认操作都不会发生。</span>
|
||
<span>将此方法调用为不可取消事件不起作用。</span>
|
||
<span>一旦<code>preventDefault</code>被调用，它将在整个事件的传播过程中保持有效。</span>
|
||
<span>该方法可以在事件流的任何阶段使用。</span>
|
||
</div> </li>
|
||
</ul> <a name="initEvent-java.lang.String-boolean-boolean-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>initEvent</h4> <pre>void initEvent(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> eventTypeArg,
|
||
boolean canBubbleArg,
|
||
boolean cancelableArg)</pre>
|
||
<div class="block">
|
||
<span><code>initEvent</code>方法用于<code>Event</code>通过<code>Event</code>创建的<code>DocumentEvent</code>值。</span>
|
||
<span>在之前，此方法只能被称为<code>Event</code>已经通过被派遣<code>dispatchEvent</code>方法，虽然它可能在该阶段，如果需要多次调用。</span>
|
||
<span>如果多次调用最终调用优先级。</span>
|
||
<span>如果从<code>Event</code>接口的子类调用， <code>Event</code>修改<code>initEvent</code>方法中指定的值，所有其他属性保持不变。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>eventTypeArg</code> - 指定事件类型。</span>
|
||
<span>此类型可以是本规范中当前定义的任何事件类型或新的事件类型。该字符串必须是XML名称。</span>
|
||
<span>任何新的事件类型不能以字符串“DOM”的任何上，下或混合大小写的形式开头。</span>
|
||
<span>该前缀保留用于将来的DOM事件集。</span>
|
||
<span>还强烈建议第三方添加自己的事件使用自己的前缀来避免混淆，并减少与其他新事件冲突的可能性。</span>
|
||
</dd>
|
||
<dd>
|
||
<code>canBubbleArg</code> - 指定事件是否可以起泡。
|
||
</dd>
|
||
<dd>
|
||
<code>cancelableArg</code> - 指定是否可以防止事件的默认动作。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |