Класс LineEvent

java.lang.Object

java.util.EventObject

javax.sound.sampled.LineEvent

Все реализуемые интерфейсы:: Serializable

public class LineEvent extends EventObject

Класс LineEvent инкапсулирует информацию, которую линия передаёт своим слушателям при открытии, закрытии, запуске или остановке линии. Каждое из этих четырёх изменений состояния представлено соответствующим типом события. Слушатель получает событие в качестве параметра метода update. Запрашивая сведения о событии, слушатель может узнать тип события, линию, вызвавшую событие, и объём данных, обработанных линией на момент его возникновения.

Хотя этот класс реализует интерфейс Serializable, попытки сериализовать объект LineEvent завершатся неудачей.

С момента выпуска:

1.3

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`LineEvent.Type`	Внутренний класс LineEvent.Type определяет, какое событие произошло с линией.

Краткое описание полей

Поля, объявленные в классе EventObject

source

Краткое описание конструкторов

Конструктор	Описание
`LineEvent(Line line, LineEvent.Type type, long position)`	Создаёт новое событие указанного типа, источником которого является указанная линия.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final long`	`getFramePosition()`	Возвращает позицию в аудиоданных линии на момент возникновения события, выраженную в кадрах выборки.
`final Line`	`getLine()`	Возвращает аудиолинию, являющуюся источником этого события.
`final LineEvent.Type`	`getType()`	Возвращает тип события.
`String`	`toString()`	Возвращает строковое представление события.

Методы, объявленные в классе EventObject

getSource

Методы, объявленные в классе 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 при нумерации с нуля или 15 при нумерации с единицы.

Обратите внимание, что это поле имеет значение только для некоторых событий, генерируемых линиями данных, например START и STOP. Для событий, генерируемых линиями, которые не подсчитывают кадры выборки, а также для любых других событий, для которых это значение неизвестно, значение позиции должно быть AudioSystem.NOT_SPECIFIED.

Возвращает:: позиция линии в виде номера кадра выборки

toString

public String toString()

Возвращает строковое представление события.

Переопределяет:: toString в классе EventObject
Возвращает:: строковое представление события

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/sound/sampled/LineEvent.html