javax.sound.sampled
类 EnumControl
java.lang.Object
javax.sound.sampled.Control
javax.sound.sampled.EnumControl
public abstract class EnumControl
- extends Control
EnumControl
提供对一组截然不同的可能值的控制,每个值都由一个对象表示。在图形用户界面中,这样的控件可由一组按钮表示,每个按钮都选择一个值或设置。例如,回响控件可能提供几个预置的回响设置,而不是连续提供应由 FloatControl
对象表示的可调整的排序参数。
只在两个设置之间提供选择的控件常被实现为一个 BooleanControl
,而在某些可计量维度之间提供一组值的控件可能被实现为具有粗分辨率的 FloatControl
。不过,EnumControl
的关键特性是,返回的值是任意对象,而不是数字值或 boolean 值。这意味着每个返回的对象都可以提供更多信息。例如,REVERB
控件的设置是可以查询用于每个设置的参数值的 ReverbType
实例。
- 从以下版本开始:
- 1.3
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()
- 提供该控件的字符串表示形式。
- 覆盖:
- 类
Control
中的 toString
- 返回:
- 字符串描述