Класс 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, у которых можно запросить значения параметров, используемые для каждой настройки.

Начиная с версии:: 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()`	Возвращает строковое представление перечисляемого элемента управления.

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

getType

Методы, объявленные в классе 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, 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/EnumControl.html