Класс FloatControl

public abstract class FloatControl
extends Control

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

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

Конструкторы

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(float, float, int)

shift

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

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

Параметры:

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

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

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

Исключения:

IllegalArgumentException - если либо from или to не попадает в допустимый диапазон

См. также:

getUpdatePeriod()

toString

public String toString()

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

Переопределяет:

toString в классе Control

Возвращает:

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