Класс 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

Модификатор и тип	Поле	Описание
`protected Object`	`source`	Объект, в котором первоначально произошло событие.

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

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

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

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

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

getSource

Модификатор и тип	Метод	Описание
`Object`	`getSource()`	Объект, в котором первоначально произошло событие.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

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.