Класс FloatControl

java.lang.Object

javax.sound.sampled.Control

javax.sound.sampled.FloatControl

public abstract class FloatControl extends Control

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

Абстрактный класс FloatControl предоставляет методы для задания и получения текущего значения элемента управления с плавающей точкой. Другие методы позволяют получить допустимый диапазон значений и разрешение элемента управления (наименьший шаг между возвращаемыми значениями). Некоторые элементы управления с плавающей точкой позволяют выполнить плавный переход к новому значению за указанный период времени. FloatControl также включает методы, возвращающие строковые метки для минимального, максимального и среднего положений элемента управления.

С версии:

1.3

См. также:

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

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

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

FloatControl(FloatControl.Type type,
 float minimum,
 float maximum,
 float precision,
 int updatePeriod,
 float initialValue,
 String units)

FloatControl(FloatControl.Type type,
 float minimum,
 float maximum,
 float precision,
 int updatePeriod,
 float initialValue,
 String units,
 String minLabel,
 String midLabel,
 String maxLabel)

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

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

Модификатор и тип	Метод	Описание
`float`	`getMaximum()`	Возвращает максимально допустимое значение.
`String`	`getMaxLabel()`	Возвращает метку максимального значения, например «Право» или «Полный».
`String`	`getMidLabel()`	Возвращает метку среднего значения, например «Центр» или «По умолчанию».
`float`	`getMinimum()`	Возвращает минимально допустимое значение.
`String`	`getMinLabel()`	Возвращает метку минимального значения, например «Лево» или «Выкл.».
`float`	`getPrecision()`	Возвращает разрешение или дискретность элемента управления в используемых им единицах измерения.
`String`	`getUnits()`	Возвращает метку единиц измерения, в которых выражены значения элемента управления, например «дБ» или «кадров в секунду».
`int`	`getUpdatePeriod()`	Возвращает наименьший временной интервал в микросекундах, за который значение элемента управления может измениться при сдвиге.
`float`	`getValue()`	Возвращает текущее значение этого элемента управления.
`void`	`setValue(float newValue)`	Задает текущее значение элемента управления.
`void`	`shift(float from, float to, int microseconds)`	Линейно изменяет значение элемента управления от начального до конечного за указанный период времени в микросекундах.
`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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt, либо истечения заданного промежутка реального времени.

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

FloatControl

protected FloatControl(FloatControl.Type type, float minimum, float maximum, float precision, int updatePeriod, float initialValue, String units, String minLabel, String midLabel, String maxLabel)

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

Параметры:: type — вид элемента управления, представленный этим объектом элемента управления с плавающей точкой; minimum — наименьшее допустимое значение элемента управления; maximum — наибольшее допустимое значение элемента управления; precision — разрешение или дискретность элемента управления. Это величина шага между отдельными допустимыми значениями.; updatePeriod — наименьший временной интервал в микросекундах, за который элемент управления может перейти от одного отдельного значения к следующему при вызове shift; initialValue — значение элемента управления при создании; units — метка единиц измерения, в которых выражены значения элемента управления, например «дБ» или «кадров в секунду»; minLabel — метка минимального значения, например «Лево» или «Выкл.»; midLabel — метка среднего значения, например «Центр» или «По умолчанию»; maxLabel — метка максимального значения, например «Право» или «Полный»
Исключения:: IllegalArgumentException — если minimum больше, чем maximum, или initialValue не входит в допустимый диапазон

FloatControl

protected FloatControl(FloatControl.Type type, float minimum, float maximum, float precision, int updatePeriod, float initialValue, String units)

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

Параметры:: type — вид элемента управления, представленный этим объектом элемента управления с плавающей точкой; minimum — наименьшее допустимое значение элемента управления; maximum — наибольшее допустимое значение элемента управления; precision — разрешение или дискретность элемента управления. Это величина шага между отдельными допустимыми значениями.; updatePeriod — наименьший временной интервал в микросекундах, за который элемент управления может перейти от одного отдельного значения к следующему при вызове shift; initialValue — значение элемента управления при создании; units — метка единиц измерения, в которых выражены значения элемента управления, например «дБ» или «кадров в секунду»
Исключения:: IllegalArgumentException — если minimum больше, чем maximum, или initialValue не входит в допустимый диапазон

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

setValue

public void setValue(float newValue)

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

Параметры:: newValue — требуемое новое значение
Исключения:: IllegalArgumentException — если указанное значение не входит в допустимый диапазон

getValue

public float getValue()

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

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

getMaximum

public float getMaximum()

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

Возвращает:: максимально допустимое значение

getMinimum

public float getMinimum()

Возвращает минимально допустимое значение.

Возвращает:: минимально допустимое значение

getUnits

public String getUnits()

Возвращает метку единиц измерения, в которых выражены значения элемента управления, например «дБ» или «кадров в секунду».

Возвращает:: метку единиц измерения или пустую строку, если метка не задана

getMinLabel

public String getMinLabel()

Возвращает метку минимального значения, например «Лево» или «Выкл.».

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

getMidLabel

public String getMidLabel()

Возвращает метку среднего значения, например «Центр» или «По умолчанию».

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

getMaxLabel

public String getMaxLabel()

Возвращает метку максимального значения, например «Право» или «Полный».

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

getPrecision

public float getPrecision()

Возвращает разрешение или дискретность элемента управления в используемых им единицах измерения. Точность — это величина шага между отдельными допустимыми значениями этого элемента управления в диапазоне поддерживаемых значений с плавающей точкой.

Возвращает:: точность элемента управления

getUpdatePeriod

public int getUpdatePeriod()

Возвращает наименьший временной интервал в микросекундах, за который значение элемента управления может измениться при сдвиге. Период обновления является обратной величиной частоты обновления значения элемента управления во время сдвига. Если реализация не поддерживает изменение значения с течением времени, она должна немедленно задать конечное значение и вернуть из этого метода -1.

Возвращает:

период обновления в микросекундах или -1, если изменение с течением времени не поддерживается

См. также:

shift

public void shift(float from, float to, int microseconds)

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

Параметры:

from — начальное значение в начале сдвига

to — конечное значение после сдвига

microseconds — максимальная длительность сдвига в микросекундах

Исключения:

IllegalArgumentException — если значение from или to не входит в допустимый диапазон

См. также:

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.