java.lang.Object java.util.EventObject javax.sound.sampled.LineEvent
The LineEvent class encapsulates information that a line sends its listeners whenever the line opens, closes, starts, or stops. Each of these four state changes is represented by a corresponding type of event. A listener receives the event as a parameter to its
its
update
method. By querying the event, the listener can learn the type of event, the line responsible for the event, and how much data the line had processed when the event occurred.
Although this class implements Serializable, attempts to serialize a LineEvent object will fail.
Nested Class Summary | |
---|---|
static class |
LineEvent.Type
The LineEvent.Type inner class identifies what kind of event occurred on a line. |
Field Summary |
---|
Fields inherited from class java.util. EventObject |
---|
source |
Constructor Summary | |
---|---|
LineEvent
(
Line
line,
LineEvent.Type
type, long position) Constructs a new event of the specified type, originating from the specified line. |
Method Summary | |
---|---|
long |
getFramePosition
() Obtains the position in the line's audio data when the event occurred, expressed in sample frames. |
Line |
getLine
() Obtains the audio line that is the source of this event. |
LineEvent.Type |
getType
() Obtains the event's type. |
String |
toString
() Obtains a string representation of the event. |
Methods inherited from class java.util. EventObject |
---|
getSource |
Methods inherited from class java.lang. Object |
---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
Constructor Detail |
---|
public LineEvent(Line line, LineEvent.Type type, long position)
Method Detail |
---|
public final Line getLine()
public final LineEvent.Type getType()
public final long getFramePosition()
Note that this field is relevant only to certain events generated by data lines, such as START and STOP. For events generated by lines that do not count sample frames, and for any other events for which this value is not known, the position value should be AudioSystem.NOT_SPECIFIED .
public String toString()