Класс EnumControl

java.lang.Object

javax.sound.sampled.Control

javax.sound.sampled.EnumControl

public abstract class EnumControl extends Control

Управляющий элемент EnumControl предоставляет управление набором дискретных возможных значений, каждое из которых представлено объектом. В графическом интерфейсе пользователя такой управляющий элемент может быть представлен набором кнопок, каждая из которых выбирает одно значение или настройку. Например, управляющий элемент реверберации может предоставить несколько предустановленных настроек реверберации вместо предоставления непрерывно настраиваемых параметров, которые представлялись бы объектами FloatControl.

Управляющие элементы, которые предоставляют выбор только между двумя настройками, часто могут быть реализованы как BooleanControl, а управляющие элементы, которые предоставляют набор значений вдоль некоторой количественной размерности, могут быть реализованы как FloatControl с грубым разрешением. Однако ключевой особенностью EnumControl является то, что возвращаемые значения являются произвольными объектами, а не числовыми или булевыми значениями. Это означает, что каждый возвращаемый объект может предоставить дополнительную информацию. Например, настройки управляющего элемента REVERB являются экземплярами ReverbType, которые можно запросить для получения значений параметров, используемых для каждой настройки.

Since:: 1.3

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

Модификатор и тип	Класс	Описание
`static class`	`EnumControl.Type`	Экземпляр внутреннего класса `EnumControl.Type` идентифицирует один тип перечисления управляющих элементов.

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

EnumControl(EnumControl.Type type,
 Object[] values,
 Object value)

Модификатор	Конструктор	Описание
`protected`	Создает новый объект перечисления управляющих элементов с заданными параметрами.

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

Модификатор и тип	Метод	Описание
`Object`	`getValue()`	Получает текущее значение этого управляющего элемента.
`Object[]`	`getValues()`	Возвращает набор возможных значений для этого управляющего элемента.
`void`	`setValue(Object value)`	Устанавливает текущее значение для управляющего элемента.
`String`	`toString()`	Возвращает строковое представление управляющего элемента перечисления.

Методы, объявленные в классе javax.sound.sampled.Control

getType

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

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

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

EnumControl

protected EnumControl(EnumControl.Type type, Object[] values, Object value)

Создает новый объект перечисления управляющих элементов с заданными параметрами.

Параметры:: type - тип управляющего элемента, представленного этим объектом перечисления управляющих элементов; values - набор возможных значений для управляющего элемента; value - начальное значение управляющего элемента

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

setValue

public void setValue(Object value)

Устанавливает текущее значение для управляющего элемента. Реализация по умолчанию просто устанавливает значение, как указано. Если указанное значение не поддерживается, будет выброшено исключение IllegalArgumentException. Некоторые управляющие элементы требуют открытия своего канала, прежде чем они могут быть затронуты установкой значения.

Параметры:: value - желаемое новое значение
Исключения:: IllegalArgumentException - если указанное значение не попадает в допустимый диапазон

getValue

public Object getValue()

Получает текущее значение этого управляющего элемента.

Возвращает:: текущее значение

getValues

public Object[] getValues()

Возвращает набор возможных значений для этого управляющего элемента.

Возвращает:: набор возможных значений

toString

public String toString()

Возвращает строковое представление управляющего элемента перечисления.

Переопределяет:: toString в классе Control
Возвращает:: строковое представление управляющего элемента перечисления

© 1993, 2021, 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/17/docs/api/java.desktop/javax/sound/sampled/EnumControl.html