Класс 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` идентифицирует один вид перечислительного контроля.

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

Модификатор	Конструктор	Описание
`protected`	`EnumControl(EnumControl.Type type, Object[] values, Object value)`	Создает новый объект перечислительного контроля с заданными параметрами.

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

Модификатор и тип	Метод	Описание
`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)

Создает новый объект перечислительного контроля с заданными параметрами.

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

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

setValue

public void setValue(Object value)

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

Parameters:: value - желаемое новое значение
Throws:: IllegalArgumentException - если указанное значение не входит в допустимый диапазон

getValue

public Object getValue()

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

Returns:: текущее значение

getValues

public Object[] getValues()

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

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

toString

public String toString()

Предоставляет строковое представление контроля.

Overrides:: toString в классе Control
Returns:: строковое описание