Класс EnumControl

java.lang.Object

javax.sound.sampled.Control

javax.sound.sampled.EnumControl

public abstract class EnumControl extends Control

Объект управления предоставляет контроль над набором дискретных возможных значений, каждое из которых представлено объектом. В графическом пользовательском интерфейсе такой элемент управления может быть представлен набором кнопок, каждая из которых выбирает одно значение или настройку. Например, регулятор реверберации может предоставлять несколько предустановленных настроек реверберации, вместо того, чтобы предоставлять непрерывно настраиваемые параметры, которые представлялись бы объектами 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/sound/sampled/EnumControl.html