JavaTM 2 Platform
Standard Ed. 5.0

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

嵌套类摘要
static class EnumControl.Type
          EnumControl.Type 内部类的实例标识了某种枚举控件。
 
构造方法摘要
protected EnumControl(EnumControl.Type type, Object[] values, Object value)
          构造一个具有给定参数的新枚举控件对象。
 
方法摘要
 Object getValue()
          获得此控件的当前值。
 Object[] getValues()
          返回此控件的可能值的集合。
 void setValue(Object value)
          设置控件的当前值。
 String toString()
          提供该控件的字符串表示形式。
 
从类 javax.sound.sampled.Control 继承的方法
getType
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

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
返回:
字符串描述

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策