javax.sound.sampled
類別 LineEvent

java.lang.Object
  java.util.EventObject
      javax.sound.sampled.LineEvent

所有已實作的介面：

Serializable

public class LineEvent
extends EventObject

LineEvent 類別封裝某一行每次打開、關閉、啟動或停止時向其偵聽器發送的資訊。這四種狀態更改中的每一種更改都由相應的事件型別表示。偵聽器將事件作為一個參數接收到其 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)
建構源自指定行的指定型別的新事件。

方法摘要

long	getFramePosition() 獲得事件發生時行的音頻資料的位置，用樣本幀表示。
Line	getLine() 獲得作為此事件的源的音頻行。
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。使用從 0 開始的計數時，要處理的下一幀應是幀號 14，使用從 1 開始計數時則應是 15。

注意，此欄位只與資料行產生的某些事件相關，如 START 和 STOP。對於不依賴樣本幀的那些行產生的事件，以及未知此值的任何其他事件而言，位置值應該是 AudioSystem.NOT_SPECIFIED。

返回：

以樣本幀數表示的行的位置

toString

public String toString()

獲得事件的字元串表示形式。字元串的內容在 Java Sound 的實作之間可能是各不相同的。

覆寫：

類別 EventObject 中的 toString

返回：

描述該事件的字元串。