模块 java.desktop
包 javax.sound.sampled

类 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 内部类的实例标识一种浮动控件。

  • 构造方法总结

    构造方法
    修饰符
    构造方法
    描述
    protected
    FloatControl(FloatControl.Type type, float minimum, float maximum, float precision, int updatePeriod, float initialValue, String units)
    使用给定的参数构造一个新的浮动控件对象。
    protected
    FloatControl(FloatControl.Type type, float minimum, float maximum, float precision, int updatePeriod, float initialValue, String units, String minLabel, String midLabel, String maxLabel)
    使用给定的参数构造一个新的浮动控件对象。

  • 方法总结

    修饰符和类型
    方法
    描述
    float
    getMaximum()
    获得允许的最大值。
    String
    getMaxLabel()
    获取最大值的标签，例如“Right”或“Full”。
    String
    getMidLabel()
    获取中点值的标签，例如“Center”或“Default”。
    float
    getMinimum()
    获得允许的最小值。
    String
    getMinLabel()
    获取最小值的标签，例如“Left”或“Off”。
    float
    getPrecision()
    以控件测量的单位获取控件的分辨率或粒度。
    String
    getUnits()
    获取表示控件值的单位的标签，例如“dB”或“每秒帧数”。
    int
    getUpdatePeriod()
    获得最小时间间隔（以微秒为单位），在该时间间隔内控件的值可以在轮班期间更改。
    float
    getValue()
    获取此控件的当前值。
    void
    setValue(float newValue)
    设置控件的当前值。
    void
    shift(float from, float to, int microseconds)
    在指定的时间段内将控制值从初始值线性更改为最终值，以微秒为单位指定。
    String
    toString()
    返回浮动控件的字符串表示形式。

    在类 javax.sound.sampled.Control 中声明的方法

    getType

    在类 java.lang.Object 中声明的方法

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • 构造方法详细信息

    • 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 - 表示控件值的单位的标签，例如“dB”或“每秒帧数”
      minLabel - 最小值的标签，例如“Left”或“Off”
      midLabel - 中点值的标签，例如“中心”或“默认”
      maxLabel - 最大值的标签，例如“Right”或“Full”
      抛出：
      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 - 表示控件值的单位的标签，例如“dB”或“每秒帧数”
      抛出：
      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()
      获取表示控件值的单位的标签，例如“dB”或“每秒帧数”。
      返回：
      单位标签，如果没有标签则为零长度字符串

    • getMinLabel

      public String  getMinLabel()
      获取最小值的标签，例如“Left”或“Off”。
      返回：
      最小值标签，如果没有设置标签，则为零长度字符串

    • getMidLabel

      public String  getMidLabel()
      获取中点值的标签，例如“Center”或“Default”。
      返回：
      中点值标签，如果没有设置标签，则为零长度字符串

    • getMaxLabel

      public String  getMaxLabel()
      获取最大值的标签，例如“Right”或“Full”。
      返回：
      最大值标签，如果没有设置标签，则为零长度字符串

    • 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 中
      返回：
      浮动控件的字符串表示形式