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

Модификатор и тип	Метод	Описание
`Control.Type`	`getType()`	Возвращает тип элемента управления.

Методы, объявленные в классе 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()`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданное время.

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

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.