モジュール java.desktop

パッケージ javax.sound.sampled

クラスLineEvent

java.lang.Object

java.util.EventObject

javax.sound.sampled.LineEvent

すべての実装されたインタフェース:

Serializable

public class LineEvent extends EventObject

LineEventクラスは、ラインが開く、閉じる、開始する、または停止するたびにラインがリスナーに送信する情報をカプセル化します。 これら4つの状態変化はそれぞれ、対応する型のイベントによって表されます。 リスナーはイベントをupdateメソッドのパラメータとして受信します。 イベントを照会することによってリスナーは、イベントのタイプ、イベントを処理するライン、およびイベント発生時にラインが処理し終えているデータ量を知ることができます。

このクラスはSerializableを実装していますが、LineEventオブジェクトを直列化しようとしても失敗します。

導入されたバージョン:

1.3

関連項目:

• Line
• LineListener.update(javax.sound.sampled.LineEvent)

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
static class	LineEvent.Type	LineEvent.Type内部クラスはラインで発生するイベントの種類を識別します。

フィールドのサマリー

クラスjava.util.EventObjectで宣言されたフィールド

source

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
LineEvent(Line line, LineEvent.Type type, long position)	指定されたラインで発生した、指定されたタイプのイベントを新しく構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
final long	getFramePosition()	イベント発生時のラインのオーディオ・データの位置を、サンプル・フレーム単位で取得します。
final Line	getLine()	このイベントの転送元であるオーディオ・ラインを取得します。
final LineEvent.Type	getType()	イベントのタイプを取得します。
String	toString()	イベントの文字列表現を返します。

クラスjava.util.EventObjectで宣言されたメソッド

getSource

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

LineEvent

public LineEvent(Line line, LineEvent.Type type, long position)

指定されたラインで発生した、指定されたタイプのイベントを新しく構築します。

パラメータ:

line - このイベントのソース

type - イベントのタイプ(OPEN、CLOSE、START、またはSTOP)

position - イベント発生時にラインがすでに処理し終わっているサンプル・フレームの数、またはAudioSystem.NOT_SPECIFIED

例外:

IllegalArgumentException - lineがnullである場合

メソッドの詳細

getLine

public final Line getLine()

このイベントの転送元であるオーディオ・ラインを取得します。

戻り値:

このイベントを処理するライン

getType

public final LineEvent.Type getType()

イベントのタイプを取得します。

戻り値:

このイベントのタイプ(LineEvent.Type.OPEN、LineEvent.Type.CLOSE、LineEvent.Type.START、またはLineEvent.Type.STOP)

getFramePosition

public final long getFramePosition()

イベント発生時のラインのオーディオ・データの位置を、サンプル・フレーム単位で取得します。 たとえば、一時停止時にソース・ラインがすでに14サンプル・フレームを再生している場合、一時停止イベントはラインの位置を14として報告します。 処理する次のフレームのフレーム番号は、ゼロから始まる番号付けを使用する場合14、1から始まる番号付けを使用する場合15になります。

このフィールドは、STARTやSTOPなど、データ・ラインで生成されたの一部のイベントだけに当てはまります。 サンプル・フレーム数をカウントしないラインによって生成されたイベントや、サンプル・フレームの値が未知のイベントの場合、位置の値はAudioSystem.NOT_SPECIFIEDになります。

戻り値:

サンプル・フレーム番号としてのラインの位置

toString

public String toString()

イベントの文字列表現を返します。

オーバーライド:

toString、クラスEventObject

戻り値:

イベントの文字列表現