293 lines
13 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">
javax.sound.sampled
</div>
<h2 class="title" title="Class LineEvent">Class LineEvent</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../java/util/EventObject.html" title="class in java.util">java.util.EventObject</a></li>
<li>
<ul class="inheritance">
<li>javax.sound.sampled.LineEvent</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">LineEvent</span>
extends <a href="../../../java/util/EventObject.html" title="class in java.util">EventObject</a></pre>
<div class="block">
<span><code>LineEvent</code>类封装了线路打开,关闭,启动或停止时线路发送监听器的信息。</span>
<span>这四个状态变化中的每一个都由对应的事件类型表示。</span>
<span>侦听器接收该事件作为其<a href="../../../javax/sound/sampled/LineListener.html#update-javax.sound.sampled.LineEvent-"><code>update</code></a>方法的参数。</span>
<span>通过查询事件,侦听器可以了解事件的类型,负责事件的行以及事件发生时线路处理的数据量。</span>
<p> <span>虽然这个类实现了Serializable但尝试序列化一个<code>LineEvent</code>对象将失败。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.3
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/sound/sampled/Line.html" title="javax.sound.sampled中的接口"><code>Line</code></a> <a href="../../../javax/sound/sampled/LineListener.html#update-javax.sound.sampled.LineEvent-"><code>LineListener.update(javax.sound.sampled.LineEvent)</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== NESTED CLASS SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="nested.class.summary">
<!-- --> </a> <h3>Nested Class Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Nested Class Summary table, listing nested classes, and an explanation">
<caption>
<span>Nested Classes</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Class and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static class </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/LineEvent.Type.html" title="class in javax.sound.sampled">LineEvent.Type</a></span></code>
<div class="block">
LineEvent.Type内部类标识一行发生的事件。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- =========== 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.java.util.EventObject">
<!-- --> </a> <h3>Fields inherited from class java.util.<a href="../../../java/util/EventObject.html" title="class in java.util">EventObject</a></h3> <code><a href="../../../java/util/EventObject.html#source">source</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/LineEvent.html#LineEvent-javax.sound.sampled.Line-javax.sound.sampled.LineEvent.Type-long-">LineEvent</a></span>(<a href="../../../javax/sound/sampled/Line.html" title="interface in javax.sound.sampled">Line</a> line, <a href="../../../javax/sound/sampled/LineEvent.Type.html" title="class in javax.sound.sampled">LineEvent.Type</a> type, long position)</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="t4"><span><a href="javascript:show(8);">具体的方法</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>long</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/LineEvent.html#getFramePosition--">getFramePosition</a></span>()</code>
<div class="block">
当事件发生时,获取线路音频数据中的位置,以样本帧表示。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../javax/sound/sampled/Line.html" title="interface in javax.sound.sampled">Line</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/LineEvent.html#getLine--">getLine</a></span>()</code>
<div class="block">
获取作为此事件的来源的音频线。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../javax/sound/sampled/LineEvent.Type.html" title="class in javax.sound.sampled">LineEvent.Type</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/LineEvent.html#getType--">getType</a></span>()</code>
<div class="block">
获取事件的类型。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<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="../../../javax/sound/sampled/LineEvent.html#toString--">toString</a></span>()</code>
<div class="block">
获取事件的字符串表示形式。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.util.EventObject">
<!-- --> </a> <h3>Methods inherited from class java.util.<a href="../../../java/util/EventObject.html" title="class in java.util">EventObject</a></h3> <code><a href="../../../java/util/EventObject.html#getSource--">getSource</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="LineEvent-javax.sound.sampled.Line-javax.sound.sampled.LineEvent.Type-long-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>LineEvent</h4> <pre>public LineEvent(<a href="../../../javax/sound/sampled/Line.html" title="interface in javax.sound.sampled">Line</a> line,
<a href="../../../javax/sound/sampled/LineEvent.Type.html" title="class in javax.sound.sampled">LineEvent.Type</a> type,
long position)</pre>
<div class="block">
构造指定类型的新事件,源自指定的行。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>line</code> - 此事件的来源
</dd>
<dd>
<code>type</code> -事件类型(
<code>OPEN</code>
<code>CLOSE</code>
<code>START</code> ,或
<code>STOP</code>
</dd>
<dd>
<code>position</code> - 发生事件时行已经处理的样本帧数,或
<a href="../../../javax/sound/sampled/AudioSystem.html#NOT_SPECIFIED"><code>AudioSystem.NOT_SPECIFIED</code></a>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>line</code>
<code>null</code>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getLine--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLine</h4> <pre>public final <a href="../../../javax/sound/sampled/Line.html" title="interface in javax.sound.sampled">Line</a> getLine()</pre>
<div class="block">
获取作为此事件的来源的音频线。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
负责此事的一线
</dd>
</dl> </li>
</ul> <a name="getType--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getType</h4> <pre>public final <a href="../../../javax/sound/sampled/LineEvent.Type.html" title="class in javax.sound.sampled">LineEvent.Type</a> getType()</pre>
<div class="block">
获取事件的类型。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
此事件的类型(
<a href="../../../javax/sound/sampled/LineEvent.Type.html#OPEN"><code>LineEvent.Type.OPEN</code></a>
<a href="../../../javax/sound/sampled/LineEvent.Type.html#CLOSE"><code>LineEvent.Type.CLOSE</code></a>
<a href="../../../javax/sound/sampled/LineEvent.Type.html#START"><code>LineEvent.Type.START</code></a> ,或
<a href="../../../javax/sound/sampled/LineEvent.Type.html#STOP"><code>LineEvent.Type.STOP</code></a>
</dd>
</dl> </li>
</ul> <a name="getFramePosition--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFramePosition</h4> <pre>public final long getFramePosition()</pre>
<div class="block">
<span>当事件发生时,获取线路音频数据中的位置,以样本帧表示。</span>
<span>例如如果源线在暂停时已经播放了14个样本帧则暂停事件将将线的位置报告为14.要处理的下一帧将是使用基于零的编号的帧号14或15使用一个编号。</span>
<p> <span>请注意,此字段仅与数据线生成的某些事件相关,例如<code>START</code><code>STOP</code></span> <span>对于不计算样本帧的行生成的事件,以及对于此值不知道的任何其他事件,位置值应为<a href="../../../javax/sound/sampled/AudioSystem.html#NOT_SPECIFIED"><code>AudioSystem.NOT_SPECIFIED</code></a></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该行的位置作为示例帧号
</dd>
</dl> </li>
</ul> <a name="toString--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>toString</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
<div class="block">
<span>获取事件的字符串表示形式。</span>
<span>字符串的内容可能因Java Sound的实现而异。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../java/util/EventObject.html#toString--">toString</a></code>在类别
<code><a href="../../../java/util/EventObject.html" title="class in java.util">EventObject</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
描述事件的字符串。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>